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WELCOME TO 
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BEGINNER'S BOOK 


ou are holding, in your hands, a piece of history. 
The Official Raspberry Pi Beginner’s Book isn’t just 
a book about a computer: It’s a book with a computer. 

Not just any computer either. The Pi Zero W is an 
incredibly well-designed microcomputer. And it’s the most 
creative programmable computer on earth. 

With a Raspberry Pi, you can hack, make and build all 
kinds of different things. It could be a digital camera, or a 
retro games console, or a home media centre. Or a sensor on 
board the International Space Station, or a programmable 
Minecraft machine. 

Everything you need to get started with a Raspberry Pi RASPBERRY PI 
computer is inside this kit. | 

Our tutorials will guide you, step-by-step, from setting up The pocket-sized desktop computer! —————— 
the Pi Zero W hardware to learning how to use the Raspbian jaa 
operating system, through to hacking electronics with the 
GPIO pins on your Pi Zero W. 

You’ ll also learn how to program a computer with Python, 
the world’s best programming language. We show coding 
the fun way, by hacking worlds in Minecraft and making your 
own games. 

We’re so glad you’ve got The Official Raspberry Pi 
Beginner’s Book. Now let’s get started... 
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06 GETTING STARTED 
Plug in and set up your Raspberry Pi 


22 BEGINNER’S GUIDE TO NOOBS 
Install the Raspbian OS with NOOBS 


24 CREATE SD CARDS WITH ETCHER 
Use Etcher to install an image file 


26 THE CONFIGURATION TOOL 
Adjust the settings in Raspbian 


28 MAKE A MEDIA CENTRE 
Create a home theatre system 


30 BEGINNER'S GUIDE TO VNC 


Remote-control the Pi from another computer 


32 THE Pl CAMERA 
Attach a camera to your Raspberry Pi 


34 SWITCH TO THE COMMAND LINE 
Work faster and smarter 


40 BEGINNER'S GUIDE TO SSH 

Access the command line remotely 
42 GPIO ZERO 

Control the pins on your Raspberry Pi 


46 HOW TO USE A BREADBOARD 
Prototype circuits 


48 CODE IN PYTHON WITH THONNY 
Discover Thonny, a Python coding tool 


50 SET UP A FILE SERVER 
Save and share files on a home network 


GETTING STARTED WITH YOUR PI ZERO W 
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06 Mw SET UP A PI CAMERA MODULE 


52 BUILD A WEB SERVER 
Share webpages on a local network 


54 BACK UP YOUR RASPBERRY PI 
Keep your files safe with a backup 


56 POWER YOUR RASPBERRY PI 
Discover the power options 


58 GET HELP FROM THE COMMAND LINE 
Find help for command-line tools 


62 MINECRAFT PI 
Start using Minecraft on your Raspberry Pi 


64 MINECRAFT PI CODING TIPS 
Hack and code Minecraft with your Pi 


68 MINECRAFT PI TIPS & TRICKS 
Expert tips and coding tricks for Minecraft Pi 


72 BEGINNER'S GUIDE TO CODING 
The rough guide to Python ona Pi 


86 UNDERSTAND OBJECT-ORIENTED CODING 
Discover this popular style of programming 


96 CODE WITH GIT 
The tool used by developers everywhere 


102 SENSE HAT EMULATOR 
Simulate the Pi hardware used in space 


104 INSIDE THE PI ZERO W 
Behind the scenes with the team who bullt it 
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CREATE SD CARDS WITH ETCHER 
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FQUIPMENT 


The microSD card in your kit acts as the hard drive for 
your Raspberry Pi. You install the Raspbian operating 
system onto the card, then all your documents, 

files, and projects are saved to it as you work. The 
microSD card in your Starter Kit is a high-quality piece 
of equipment and comes with NOOBS pre-installed. 

If you want to use a larger card, and are wondering 
which brand and type to get, take a look at the results 
from benchmark tests done by Raspberry Pi fan Jeff 
Geerling. Some cards run up to four times as fast as 
others. You can read more at magpi.cc/2bncFs3. 
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microSD card here can connect standard 
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Welcome to the Claws Mail setup wizard 


We will begin by defining some basic information about you 
and your most Common mail options so that you can start 


Pre Shared Key | 


Cancel 


OK 


BLUE LOOIH 


Devices connected 
by Bluetooth work 
wirelessly with your 
Raspberry Pi 


Start by putting your Bluetooth device 
in Pairing 7 Discoverable mode. We're 
using an Apple wireless keyboard 
here. Hold down the power button 
until the LED flashes. Click Bluetooth 
in the Panel and choose Add Device. 


Tum Off Bluetooth 


Make Discoverable 


The Add New Device window opens 
and will scan for nearby Bluetooth 
devices. Some will have names, 

others just identifying numbers (check 


on the device). Choose a device from 
the list and click Pair. 


Searching for Bluetooth devices. 


@) 45-97-84.09-22-F5 


@© 00-03-48-18.40.42 
@) 42-10-0F-96-96-1€ 


Care! 


The Pi now attempts to pair with the 
Bluetooth device. You'll be asked to 
enter a code on the keyboard; press 
the buttons and RETURN. You can 
now start using the Bluetooth device 
with your Raspberry Pi. 


Please confirm that device ‘Lucy's MacBook Pro’ 
is showing the code 776706’ to connect 


OK 


Cancel 
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The easiest way to set up a Raspberry Pi with Raspbian, 
and other operating systems, is to use the NOOBS installer 


micro SD card 
(8GB or larger) 


/ NOOBS 
installation files es 
, | Your starter kit micro SD card is already 


set-up with NOOBS and ready to use 
Linux machine 


Click the Install button Connect to a wireless 
to format your micro SD network (or attach an Ethernet 
card and install the selected cable) to access a wider range 
operating system of operating systems 
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BEGINNER'S GUIDE 


> Raspberry Pi 


 Raspbian Jessie 
with PIXEL 


Password: Change Password... 
Hostname: raspberrypi 


Boot: © To Desktop © To CLI 
Auto Login: As current user 
Network at Boot: _) Wait for network 


Splash Screen: O Enabled ©) Disabled 


Resolution: Set Resolution... 


Underscan: @) Enabled © Disabled 
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Options to expand the file system and change password 
and hostname sit alongside various login choices. 


Support for the various hardware and software 
features, such as Camera Module, SSH, and VNC. 


Overclocking and GPU memory options can improve 
the performance of a Raspberry Pi. 


Set up an international keyboard, global WiFi options, 
and adjust the locale and time zone. 


Raspberry Pi Configuration = x 


System nterfaces | Performance | Localisation 


interfaces Perfor ocalisation 


SSH ®) Enabled sable 
IC ®) Enabled Disabled 

SP enabled 
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Remote GPIC Enabled ©) Disabled 
Cance OK 
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x Keyboard Layout 


System interfaces Performance | Locelisat Country Variant 


Build your home theatre media centre with a Raspberry Pi and OSMC 


uilding a media centre, or HIPC (home 
theatre PC) is one of the most rewarding 
projects a newcomer can complete. 

It’s easy to turn a Raspberry Pi into an HTPC, and 
you can quickly hook it up to your television. 

Using an HTPC, you can play video and music files, 
and stream video and audio from online services. And 
unlike proprietary systems, such as Apple TV and 
Google Chromecast, you can use it to play just about 
any media format. 

You can add streaming services to your HTPC, such 
as BBC iPlayer and Soma radio stations. These enable 
you to play media directly from the internet. 

There are several pieces of software available for 
setting up an HTPC. Two options you’ ll find on the 
Raspberry Pi Foundation’s Downloads page are OSMC 
and LibreELEC. Both are similar and run a media © = @ 


SELECT IMAGE SELECT ORIVE FLASH IMAGE 


player called Kodi. O O O 
In this guide, we’re going to opt for OSMC. It’s a 


free and open-source media centre built on top of 
Debian, and is reliable and easy to use. 

Setting up OSMC on a Raspberry Pi is are 
a Straightforward and rewarding project. 
Let’s get started. 
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Remotely control your Pi from another computer with VNC Server and Viewer 
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O)No scaling 
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By using the command line, you are able to work faster and smarter. 
Discover how to get started today... 
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pi@raspberryp1: 
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pl@raspberryp1: 
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a file.txt 


The permission structure 
of a Unix file or directory 
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directory owner group other 


System 
Filesystem: 
Password: 
Hostname: raspberrypi 
Boot: © ToDesktop © 
Auto Login: ‘ Login as user ‘pi’ 
Network at Boot: ) Wait for network 


Splash Screen: © Enabled © Disabled 
Underscan: ©) Enabled © Disabled 
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Options 

Most commands have options that affect how they 
work. It’s common to use these three options with 
the 1s command: 


ls -lah 


Options start with a single hyphen ‘-’ followed the 


letter for each option. The three options used here are: 


-1 = long listing format 

-a = all including hidden files 

-h = human-readable (makes large file sizes 
more readable) 


Options are case-sensitive. Sols -landls -Lare 
two different things (small ‘I’ is long listing format; 
large ‘L’ is dereference mode). Sometimes options are 
listed out in full. These start with two hyphens and 
have a single hyphen for spaces. This command is the 
sameasls -lah: 


ls -1 --all --human-readable 


But it’s more common to see (and use) the single 
letter approach. 


Sudo 
Sudo stands for ‘substitute user do’, although it’s 
often also called ‘superuser do’. If you have multiple 
users On your system, it can be used to perform 
commands as another user. 

It’s mostly used to get root access to your Linux 
installation. There is an account that controls your 
Pi user, called ‘root’. This is an all-powerful account, 


which can change just about anything on your system. 


Your default account can view files in the root of 
the hard drive, but it can’t create or delete files at 
the root. Enter: 


cd / 
touch test.txt 


You’ll see touch: cannot touch ‘test.txt’: 
Permission denied. However, enter: 


sudo touch test.txt 


..and the test.txt file will be created on the root of 
your hard drive. You can see it using1s -1. 
Now try to delete it: 


rm test.txt 
It will say rm: remove write-protected regular 
empty file ‘test.txt’?” Enter Y and it’ll say rm: 


cannot remove ‘test.txt’: Permission denied. 
You need to use sudo to remove the file: 


raspberrypi.org/magpi 


COMMAND - 


sudo rm test.txt 


You can see why sudo is such a powerful tool. 
Without it, you couldn’t install software using apt 
or apt-get. But with it, you can remove or delete vital 
system files. Enter1s /bin and you’ll see many 
programs (known as ‘binaries’) used by Linux. These 
include the 1s command you just used. Accidentally 
deleting these files could make your system unstable. 

So use sudo with care. In Raspbian you don’t need to 
enter the password to use sudo. On many other Linux 
systems, however, you will be asked for the password 
before you can use sudo. 


What's up, man? 

There are lots of ways of getting help inside the 
command line. The first command you should turn 
to is man. This stands for ‘manual’ and gives you 
instructions on Linux commands and tools. Enter: 


man ls 


...and you’ll see the manual for the list command. 
Notice under the SYNOPSIS it says: 


ls [OPTION]... [FILE]... 


This shows you the structure of the command. 
Almost all commands are in the ‘command, option, 
argument’ structure, although some arguments have 
more than one [FILE] argument (such as copy, which 
requires a source and destination file). 

Press the space bar to move down the instructions. 
Here you will see a list of all the available options. 
With man, you can get detailed information on just 
about every tool on the command line. You can even 
get a manual for the man command with: 


man man 


If you need a quick reminder on how to use a 
command, try using it with -h or --help as an option: 


touch --help 


...tells you what options are available with the touch 
command. You can use this with many command-line 
tools to get a quick refresher on how they work. 

Moving from a GUI to acomman4d line is a vital skill for 
hackers and coders. Everything on your computer, from 
programs to preferences, is stored in the file system 
somewhere. Learning to use the command line makes 
you a more capable Raspberry Pi user. 

So, the next time you make a file, move a file, or 
delete something, don’t head to the File Manager. 
Open Terminal and perform tasks from the 
command line. Soon it’1l be second nature. 
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Terminal 


tx] pi@raspberrypi: ~ 


Lucy@Lucy-MacBook:~$ ssh pi@192.168.0.19 
The authenticity of host '192.168.0.19 (192.168.0.19)' can't be established. 
ECDSA key fingerprint is SHA2S6:k2RP2BuKYuu1UF79nN1WT8SVv+6ZGLF3mg3r yH4z0/oSE. 
Are you sure you want to continue connecting (yes/no)? yes 

Warning: Permanently added '192.168.0.19' (ECDSA) to the List of known hosts. 


pi@192.168.0.19's password: 


The programs included with the Debian GNU/Linux system are free software; 
the exact distribution terms for each program are described in the 
individual files in /usr/share/doc/*/copyright. 


Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent 
permitted by applicable Law. 

Last login: Tue Dec 6 10:14:12 2016 from 192.168.0.38 
piGraspberrypi: ls 
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system 
Camera: 
SSH 


VNC 


Seria! 
1-Wire 


Remote GPIO 


Enabled 
Enabled 
Enabled 
Enabled 
Enabled 
Enabled 
Enabled 


Enabled 


Cancel 


Interfaces | Performance | Localisation 


Disabled 
Disabled 
Disabled 
Disabled 
Disabled 
Disabled 
Disabled 
Disabled 


OK 


Category: 
=} Session Basic options for your PUTTY session 
" — Specify the destination you want to connect to 
= enmina . 
Risin Host Name (or IP address) Port 
: '192.168.0.19 [29 
Bell sree one 
Features Connection type: i" : 
Window ()Raw ()Teinet ©)Riogin @SSH (©) Seal 
Appearance 
te : 2 Load, save or delete a stored session 
ehaviour 
Selection | 
C Colours Default Settings Load 
a ah = =} Connection 
B) Ga [rm i> i@raspbemypi: ~ 
sors CY Em recspbenp Data Save 
Er . Proxy 
Telnet Delete 
Riogin 
+)» SSH 
Serial Close window on exit 
©) Always (©)Never @)Only onclean ext 
About Open Cancel 
op pi@raspberrypr ~ - oO 


©©© tucy@lucy-MacBook: ~ 

Lucy@lucy-MacBook:~$ ssh pi@192.168.6.19 

The authenticity of host '192.168.6.19 (192.168.6.19)' can't be established. 
ECDSA key fingerprint is SHA256:k2RP2BuKYuUlUF79NIWTBSV+6ZGLF 3mg3ryH4z0/oSE. 


«Are you sure you want to continue connecting (yes/no)? yes 


ep pi@raspberrypr ~ - O 
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Discover the easy way to control GPIO pins on your Raspberry Pi 
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>STEP-07 

Adding a button 

Now we’re going to add a button to our circuit and 
connect it to GPIO21 with an LED wired up to GPIO17. 
Buttons are wired up ina similar fashion to LEDs, 
using female-to-male jumper leads. 

Like LEDs, buttons have legs. One leg is wired to a 
GND pin (via the same ground rail you’ve been using 
for LEDs); the other leg is connected to a GPIO pin. 
Some buttons have four legs, so you can connect 
them to the breadboard with their legs straddling 
the central groove (see the breadboard diagram). 


>STEP-08 

Button responder 

Unlike LEDs, you don’t need to use a resistor with a 

button. The button’s legs are the same length, and it 
typically doesn’t matter which way around you hook 
it up to the breadboard. 

When the button is pushed, it forms a connection 
between the ground rail and the pin, completing a 
circuit. The Raspberry Pi is set up, using GPIO Zero, 
to detect this connection and respond. 

Open Python shell and create a new file. Enter the 
code from button.py, save the file, and run the code. 
When you push the button, the LED will light up. 
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Going further 


qanguage 


>PYTHON 


DOWNLOAD: 
magpi.cc/2ehTqVq 


button.py 


from gpiozero import LED, Button 
from signal import pause 


led = LED(17) 
button = Button(21) 


button.when_pressed = led.on 
button.when released = led.off 


pause() 


traffic_lights.py 


from gpiozero import LED 
from time import sleep 


red = LED(25) 
amber = LED(8) 
green = LED(7) 


green.on() 
amber .off() 
red.off() 


while True: 

Sleep(10) 
green.off() 
amber .on() 
sleep(1) 
amber .off() 
red.on() 
sleep(10) 
amber .on() 
Ssleep(1) 
green.on() 
amber .off() 
red.off() 


Magi 


SIMPLE 
ELECTRONICS 


You can achieve a lot more with GPIO Zero than 
controlling LEDs and buttons. 
For a more detailed look at how you can detect 


cpioZERO 


vom Raspberry Pi 


motion, control robots, read sensor information 
(such as movement sensors or thermometers), 
The MagPi's Phil King has created a fantastic guide: 
MagPi Essentials: Simple Electronics with GPIO Zero. 


Learn more at magpi.cc/Back-issues. 
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Tutorial | RASPBERRY PI 101: CODE IN PYTHON WITH THONNY 


~~ - y 


Use the new Thonny IDE to understand what’s going on in your code 


> Raspberry Pi 


> Latest version 
of Raspbian 


> Thonny 


rays — —- 
print("Hello World")| 


ae 
python 3.4.2 


>>> %Run hello.py 

Hello World! 

>>> name = “Lucy” 

>>> print("Hello " + name) 
Hello Lucy 


| File Edit View Run Tools Help 


Js reed e 


class Animal(): 
def _init (self, ¢, mn): 
self.creature = ¢ 


You can see the values self.neme =n 
stored in your variables as 
you run the program 


return self.creature 


def get_name(self): 
return self.nane 


animals = [) 
| 6x7688A5F8 ap nol Fido") IP 
animals .append(Animal{ "Mouse", “Nibbles”)) 


In debug mode, Thonny Sabet 
highlights code andrunsitone step at [aiibinsi 
a time, so you can see what each code 


element is doing 


The Heap window displays the Nine cin Anca lao 
memory addresses of objects, functions, i pepe acme 
and other elements of your program 


Claws is o Cat Ss ; : ees | is é aes 
Wabbles is a Mouse Ci ap ‘ ( ie eG ] ‘a) . IH 


2>> Webug animals.py 
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n= 10 
le n> 0: 
prantin) 
new] 


print( “Blast 


off! 


offt'*) 


) 


n= 3 


oem 


def countin): 
if n> 6: 


print(n) 


count(n-1) 


else 
print("Blast off!") 


count(3) 


def 


counti(n): 


els 


print(n) 
count(n-1) 


print("Blast off ) 


animals.py 


class Animal(): 
def init ( pe Gein) 
.creature C 
.name n 


def get_creature( ye 
.creature 


def get_name( ): 


.name 

animals [ | 

animals .append(Animal( : )) 

animals. append (Animal ( ; )) 

animals.append(Animal ( ’ )) 
animal animals: 


name = animal.get name() 
creature = animal.get_creature() 
print(name creature) 


countdown_recursion.py 


n 

def count(n): 
n : 

print(n) 

count(n-1) 


pine ) 


count(n) 


countdown.py 


n 
print(n) 
n 


print( ) 


RASPBERRY PI 101: SET UP A FILE SERVER 


Turn your Raspberry Pi into a file server to back up and share content 
from anywhere on your local network 


A 32GB micro and widely supported by media streamers 
SD card 


Raspberry Pi 2/3 This tutorial assumes that you’ll use a key 


keyboard and can alternatively enable SSH (magpi.cc/1C 1Tr) averything from music f 
mouse (for | | 
setup) 


Wired Ethernet 
connection 


NOOBS De ie aie Pe aimee he eee pee 
2bnf5XF J accessible. However, 1f you need extra storage, it’s easy 


| File Edit Search Options Help 
'# printer drivers 
[print$] 
comment = Printer Drivers 
ath = /var/lib/samba/printers 
rowseable = yes 
read only = yes 
guest ok = no 
# Uncomment to allow remote administration of Windows print drivers. 
‘# You may need to replace ‘lpadmin' with the name of the group your 
# admin users are members of. 
# Please note that you also need to set appropriate Unix permissions 
# to the drivers directory for these users to have write rights in it 
; write list = root, @lpadmin 


An entry in /etc/samba/ 


[share] This is the location of the 
comment = Pi shared folder folder we're going to share 
path = /share 
browseable = yes 
writeable = yes 
only guest = no 
create mask = 0777 We've enabled guest access, so 


direc tory mask = 0777 network users won't need a username 
: and password to access the share 
public = yes 


guest ok = yes 
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smb.conf will create the top-level 
directory of your share 


Organize New folder 


Recent Places 
ownCloud 

we Upreries 
Decuments 

@) Music 
me! Pic 


#3, Homegroup 


™ Computer 


ei Network 
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RASPBERRY PI 101: BUILD AN INTRANET WEB SERVER 


Build a local HTML server with Apache 


Raspberry Pi 2/3 

Monitor, vebsites that don’t require the capacitv or serve! NOOBS ¥2.2- Built: Feb 2 

keyboard, and Rie aN eee Te tee Re rest ea RS Le 2 @ a 

mouse (for setup) 1G eter mnelS < tb ULd livle pure UlLeCUTTIPVULEI Instat (i) Full Contig (e) Wil networks (w) Online help (hy) Exit (ee) 

Wired Ethernet Goes. — = 

connection LO USe Siete of3 LiDreELEC Ss a fast and user-friendly Kodi Entertainment Center distributlén. 
I log or to-do list, keep a o (0 posh of cbt jichnfar nnaibairy intima wring 

micro SD card oe ee ee i ee re ccaiise 

“ 7. . | . : e ' : o 2 _ My “1 = . : : E r ’ : we o | pcr Ee ene Ry s 

tee te : : ee QD BEES artes nn arco nace 

2bnf5XF ie 


raeneocepm: 
TWand movies [| Funny [| hardwore [| Cos || gomes vintage computing [| Blogt || poetry » 


7x 


€ > G © 192.268.178.167 


The Custard Conundrum 


Your site's title, like its 
structure, is defined in the HTML 
code of the pages you upload to it 


This is the address 
of your new website 


Your new website 
(custard optional) 
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id replace this file 


si file nemized for irtcre<t tho 


v ‘ F with Debion took. TI ation systery fully documented 
in /use/share/doc/apache2?/README.Debian.gz, Reter to this for the full docunertatio 


ment, 


r the web server itself can be fou ¥ accessing the manual if the apache2-d 


High Contrast Cats 


Back up the files on a Raspberry Pi so you can quickly restore your files 


Raspberry Pi 
SD card 


Flashdrive J sady-te ca jou he 


Adding a password to your backup can secure the 
files stored remotely (or on an external drive) 


Déja Dup is a popular program Files backed up using Déja Dup are 


used to schedule backups 


restored using the same program 


[| - « 


on 


Require Password? —~ Last backup was today. 
Folders to save f= = You can restore the entire backup with the Restore... button or use Files to either 
© Allow restoring without a password revert individual files 01 restore missing ones. 
® Password-protect your backup Folders to ignore 
tore. 
You will need your password to restore your files. Storage location — 
You might want to write it down. 


Scheduling 


No backup scheduled. 
You should enable automatic backups or use the Back Up Now... button to start one now. 


Back Up Now 


cerptopasnod| = 
a 


.) Show password 
() Remember password 
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BACK UP YOUR RASPBERRY PI 


Restore Finished 


Your files were successfully restored. 


vy No recent backups. 
9 You may use the Restore_. button to browse for existing backups. 
L Restore. J 


No backup scheduled. 
You should enable automatic backups or use the Back Up Now... button to start one now. 


Above: =|\== 
can be restored 
individually, or 


S Win32 Disk Imager 


You can clone you 
dd ona Mac or Linux, and Win32 D 


raspberrypi.org/magpl 


Don’t let your Raspberry Pi suffer from a shortage of volts 


= | 
F = 
SS | 


Raspberry Pi ModelA 
Raspberry Pi Model B 
Raspberry Pi Model A+ 
Raspberry Pi Model B+ 
Raspberry Pi 2 Model B 
Raspberry Pi 3 Model B 
Pi Zero / Pi Zero W 


=| 


The Raspberry Pi lower Usac 
Universal Power Supply 

is a reliable source of (B+) i 2B 12 B 
power for your board rors at oe 
Boot Max 0.26A 0.40A 0.75A 

Avg 0.22A 0.22A 0.35A 
Idle Avg 0.20A 0.22A 0.3a0A 

Video playback (H.264) Max 0.30A 0.36A 0.55A 

Avg 0.22A 0.28A 0.33A 

Stress Max 0.35A 0.82A 1.34A 

Avg 0.32A 0.75A 0.85A 


0.20A 
0.15A 
0.10A 
0.23A 
0.16A 
0.35A 
0.23A 


Test conditions used a standard Raspbian image (26 Feb 2016), at room 
temperature, connected to an HDMI monitor, USB keyboard, and mouse. 
For the Model 3B it was connected to a WiFi access point. All these power 
measurements do not take into account power consumption from additional 
USB devices; these measurements can easily be exceeded with multiple 
additional USB devices connected or when using a HAT. 


500mA 

500mA 

500mA 

600mA/1.2A (switchable) 
600mA/1.2A (switchable) 
1.2A 


1.2A 


200mA 
500mA 
180mA 
330MA 
350MA 
~400MA 


200MmA 
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The basic commands you need to get advice from the Linux command line 


® OCB ® CO E¥ecestenp - % TL 4) [Rea 1317 


mm) CY (= fi , 
} G) f | ‘> >. @raspbenypi: ~ 


Many commands 
feature a built- 
in help option, 

t le: accessed with -h 
specified, use tmp 1s or --help. Using it 
Cea ee et offers a brief outline 


% 
c Braspbemp ~ 

ss) (2 y pi@raspberyp 

ele ty >| wil 

a 4 
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Get off to a good start with Minecraft: Pi Edition. 
Play the game and write your first program using the API. 


The mouse changes where you look 

Holding the left button destroys blocks 

Right button places blocks 

W, S, A, D move you forward, backward, left, 
and right 

1, 2,3, 4,5, 6, 7, 8 change what you are holding 
E opens the inventory 

ESC takes you back and to the Menu 

SPACE is jump. Double-tapping it makes you fly 
or stop flying 


Lal Minecraft - Pi edition [-JlelL 
- 9.0; 57.7 


ello Minecr aft Wor Ld 


Get the player’s position 

Change (or set) the player’s position 

Discover the type of block at a specific location 
Change a block 

Change the camera angle 

Post messages to the player 


Go to the Minecraft menu with ESC, but leave 
the game running (you can minimise it). 
Open IDLE by clicking Menu > Programming > 


WATCH FOR 
RED TEXT 
Use File > New File to create a new program and 


Python 3 (IDLE). 


save it as hellominecraftworld.py. 

At the top of your program, type the following 

code to import the minecraft module, which 

will allow you to use the API and talk to the game: 

import mcpi.minecraft as minecraft 

On the next line, create a connection from your 

program to Minecraft and call it me: 

mc = minecraft.Minecraft.create() 

Use your Minecraft connection and the 

function postToChat() to put a message in 

the chat window on a third line: PYTHON 
mc.postToChat("Hello Minecraft World") IS CASE- 
Run your program by clicking Run > Run Module. SENSITIVE 


All blocks in 
Minecraft have a 
position of X, Y, Z 


Teleport the player by setting their position: 
mc.player.setPos(@, 50, @) 

Run your program by clicking Run > Run Module. 
Quickly switch back to Minecraft to see your 
player fall to the floor (unless in flying mode). 


If you’ve completed the Minecraft Pi learning resources at 
raspberryp1.org, check out these pro tips and mini programs 
to learn more about the coding in Minecraft... 


Create massive 
houses in the blink of 
an eye using just a few 
lines of code 


MagPi 
FACKINGanp 


CODE VIRTUAL WORLDS 
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CHANGE THE CAMERA 


Bored of always following Steve around? You can alter 
the position of the ‘camera’ in Minecraft to change how 
you see the world. 

You can change the camera to follow Steve while 
looking directly down at him, or to look down at the 
world from any coordinate in Minecraft. 

The camera. setFollow() function will change your 
view so you are looking down at Steve. In a new Script: 


from mcpi import Minecraft 
mc = minecraft.Minecraft.create() 


mc.camera.setFollow() 


To change the camera to look down on any position, 
you use the camera.setFixed() function before using 


camera.setPos() to change the position of the camera. 


If you wanted to set the camera 25 blocks above the 
Spawn position, you would use: 


mc.camera.setFixed() 
mc.camera.setPos(@, 25,Q) 


use the camera. setNormal() function. 
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To set the camera back to normal, you would 


mc.camera.setNormal() 


Using the camera functions, you could hide a 
diamond block (57) in the world, then tease the 
player by changing the camera to show them where 
it is before challenging them to find it. Try this ina 
new program: 


from mcpi import minecraft 
from time import sleep 
mc = minecraft.Minecraft.create() 


mc.postToChat("Here is the ceed ¢ 
block I have hidden." ) 
mc.setBlock(100,25,100,57) 
mc.camera. setFixed() 
mc.camera.setPos(100, 30,100) 
sleep(10) 


mc.postToChat("Go find it!") 
mc.camera.setNormal() 


You could change the program above to drop 
the diamond block in a random position and use 
getHeight() so the diamond block is always on the 
top of the world. 
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mcpi minecraft 
mc = minecraft.Minecraft.create() 


#make the world read-only 
mc.setting( » True) 


#make the world writable 


mc.setting( » False) 
mcpi minecraft 
time Sleep 


mc = minecraft.Minecraft.create() 
mc.setting( » True) 
mc .postToChat ( 


sleep(10) 
mc .postToChat( ) 


mc. setting ( . False) 
Sleep(60) 
mc. postToChat ( 


) 
mc.setting( » True) 


Have you exhausted the Minecraft: Pi basics available from raspberryp1. 
org/resources: Have you completed our Minecraft Pi coding tips? Here 
are another five tips and mini-programs to experiment with... 


pi@rpi2 cd ~/.minecraft/games/com.mojang/minecraftWorlds 
p1@rpi2 ls 


p1i@rpi2 


tar czf world--backup.tar.gz world-- 
p1@rpi2 


world--backup. tar.gz 


p1i@rpi2 
tar xzf world--backup.tar.gz 
p1i@rpi2 
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mcpi minecraft 
mcpi block 


mc minecraft.Minecraft.create() 


pos mc.player.getTilePos() 


mc.setBlock(pos.x, pos.y », pos.z, block.STONE) 


# create torches 

# on top 

mc.setBlock(pos.x, pos.y >, pos.z, block.TORCH) 

# to the east 

mc.setBlock(pos.x y pos.y -» pos.z, block.TORCH) 
# to the west 

mc.setBlock(pos.x y pos.y -» pos.z, block.TORCH) 
# to the north 

mc.setBlock(pos.x, pos.y » poOs.z » block.TORCH) 
# to the south 

mc.setBlock(pos.x, pos.y ¥, pos.z » block.TORCH) 


mcpi minecraft 
minecraft.Minecraft.create() 
mc.saveCheckpoint( ) 


mc.restoreCheckpoint() 


mcpi minecraft 
time sleep 


minecraft.Minecraft.create() 


#every 3@ secs save a checkpoint 
count : 
mc.saveCheckpoint() 
mc.postToChat("Checkpoint saved") 
count 
sleep(1) 


#if a block is hit, restore checkpoint 
mc.events.pollBlockHits(): 
mc.restoreCheckpoint() 
mc.postToChat ("Restoring 
checkpoint" ) 


-_—_ 
alle 
By 
—h 


- 
= = 
Pails iisil 


Li] i 


ap 


Fn 


1 I, Es 


[Dee ee p en 


ar 


Gat fat ot mrs 


CALCULATING THE DISTANCE 
BETWEEN TWO BLOCKS 


When coding Minecraft, it’s really useful to know the 
distance between two blocks — and by using some 
(fairly) simple maths, we can work it out. This can 
be used in loads of fun ways, such as a hide and seek 
game where a diamond block is hidden and Steve is 
told whether he is getting colder or warmer. 

The maths works like this: 


MINECRAFT: PI 


from mcpi import minecraft 
from math import sqrt 

from time import sleep 

mc = minecraft.Minecraft.create() 
startPos = mc.player.getTilePos() 


while True: 


posNow = mc.player.getTilePos() 


Tutorial 


01 Calculate the difference between the x, y 


& z coordinates of the two positions 


02 Multiply the difference by itself (its square) 


03 Add all the squares together 


04 The distance equals the square root 


of the total above 


xDiff = startPos.x - posNow.x 
yDiff = startPos.y - posNow.y 

zDiff = startPos.z - posNow.z 
xSquare = xDiff * xDiff 

ySquare = yDiff * yDiff 

zSquare = zDiff * zDiff 

total = xSquare + ySquare + zSquare 


This program uses this calculation to display how 
far the player is from where they started. So the 
further they move away, the greater the distance. See 
how it works by copying the following code example 
into IDLE or your favourite text editor (don’t forget to 
save it with the .py file extension): 
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distance = sqrt(total) 
mc.postToChat (distance) 


sleep(1) 


Try changing the program to show the distance between 
the player and a random diamond block you have created. 
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MM  carning to code is one of the most profoundly 
i life-changing things you can do. This has 
"always been true, but learning to code is 
increasingly important in the modern world. 

The reason the Raspberry Pi was created was to 
» challenge a drop in computer science applications 

at Cambridge University. Modern computers, and 

especially games consoles, were fun and powerful, 
but not easily programmable. 
The maker community fell in love with the 
Raspberry Pi, thanks to its cheap and hackable 
nature. Building and tinkering are the primary 
reasons we love Raspberry Pi. Great projects use a 
combination of hardware and software together. 

So, whether you’re a hacker learning to make 
better projects, or a would-be coder looking for 
a better career, this feature is set to help you on 
YOUL Way. 

The good news is that you don’t need to be a genius 
to know coding, just as you don’t have to be a genius 
to read and write. It’s actually pretty simple once you 
learn a few simple concepts like variables, branching, 
and loops. 

Perhaps you’re brand-new to coding. Maybe you 
did a little BASIC in school, or used old languages like 
Pascal and Fortran. Or maybe you’re already knee- 
deep in projects and just want to learn the language 
that controls them. 

Wherever you’re coming from, we’re here to 
walk you through the basic concepts of computer 
programming. We’ll demystify the whole process of 
code, so you can get a better understanding of what’s 
going on inside your Raspberry P1. 
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Code Matters 


“| think everybody in this country should learn to program a 
computer,” said Apple's co-founder Steve Jobs, “because it 
teaches you how to think." 

Code is a critical layer in our lives that sits between us 
and the increasingly digital world that surrounds us. With 
just a small amount of understanding how code works, 
you'll be able to perform computer tasks faster and get a 
better understanding of the world around you. Increasingly, 
humans and machines are working together. 

Learning to use code and hardware is incredibly 
empowering. Computers are really about humanity; it’s 
about helping people by using technology. Whether it’s the 
home-made ophthalmoscope saving eyesight in India, or 
the Computer Aid Connect taking the internet to rural Africa, 
code on the Raspberry Pi is making a real difference. 

Coding also makes you more creative. It enables you to 
automate a whole bunch of boring and repetitive tasks in 
your life, freeing you up to concentrate on the fun stuff. 

It also teaches you how to solve problems in your life. 
Learning to how to put things in order, and how to break 
down a big, seemingly impossible task into several small 
but achievable tasks is profoundly life-changing. 

And if you're looking for a career boost, there's plenty of 
worse things to learn. “Our policy is literally to hire as many 
engineers as we can find,” says Mark Zuckerberg, CEO 
of Facebook. “The whole limit in the system is that there 
just aren't enough people who are trained to have these 
skills today.” 
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Python 2 and 
Python 3 are both 
commonly used. 
Python 3 is the 
future, so we're 
going with it. Lots 

of courses still teach 


Python 2, and it's 
not a bad idea to 
take a closer look 
at the differences 
between the two: 
magpi.cc/2gP6zX3 


Python is an ‘interpreted language’ 
You write the code and then run the 
program. Under the hood, it’s being 
translated and runs on the fly. Some 
languages, such as C and Java, are 
compiled. You write the program, then 
compile it to get a build file (written in 
machine code), then you run the build. 
It's a faff you can do without for now. 


Discover the building blocks of software 
@ and learn what goes on inside a program 


efore you go any further, let’s look at what a 
program actually is. The dictionary definition 
is a “set of instructions that makes a 
computer do a particular thing.” 

A computer program is a lot like a recipe. It has 
a list of ingredients, called ‘variables’, and a list of 
instructions, known as ‘statements’ or ‘functions’. 
You follow the instructions from the recipe one line at 
a time and end up with a tasty cake - and that’s no lie. 

The real miracle of computers, however, is that 
they can do the same thing repeatedly. So you can 
get a machine to bake a thousand cakes without ever 
getting tired. A program may contain loops that make 
it do the same thing over and over again. 

Programs also make decisions, and different paths 
through a program can be taken. Your recipe could 
make a scrummy chocolate cake or a delightful 
batch of doughnuts, depending on the variables (the 
ingredients) it has. 
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One thing that may surprise you when you begin 
programming is just how little you need to know to 
eet started. With just a few variables, a smattering 
of flow, and some functions, you can get a computer 
doing all the hard work for you. 


Inside your Pi 

At the heart of your Raspberry Pi are billions of voltage 
switches known as binary digits (or ‘bits’ for short). 
There are 8,589,934,592 of them in its 1GB of RAM, to 
be exact. All these switches can be set to high or low, 
which is typically represented as o (for low or off) and 
1 (for high or on). Everything you see on the screen, 
hear from the speakers, and type on the keyboard is 
billions of switches being turned on and off. 

Obviously, it’s not that easy for humans to talk 
directly to computers. It’s possible to use machine 
language and send binary instructions directly toa 
computer, but this isn’t where any sane person starts 
(or ends if they want to remain sane). 

Instead, we use a coding language to program. This 
is written using easy-to-understand functions like 
print(). These are then interpreted into machine 
language, which the computer understands. 

We’re going to use Python to learn to code. Python 
is a truly great programming language. It has a rich 
syntax that’s free from clutter, you don’t have to 
worry about things like curly braces and static typing 
that crop up in more complicated languages like Java. 

With Python, you can just create code, run it, and get 
things done. Python is one of the languages found most 
commonly on The Raspberry Pi, so learning it here will 
help you understand lots of the code used in projects. 
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IDE and IDLE 


You don’t have to write Python programs using a text 
editor like Leafpad and run them in the terminal. 
Instead, you can use a neat all-in-one solution, known 
as an ‘IDE’ (integrated development environment). 

IDEs combine a text editor with program-running 
functionality. Often, they’1l include fancy features like 
debugging and text completion. 

Click Menu > Programming > Python 3 (IDLE), and 
you’ ll get a new window called ‘Python 3.4.2 Shell:’. 
This Shell works just like Python on the command line. 
Enter print("Hello World") to see the message. 

You can also create programs in a built-in file 
editor. Choose File > New File. Enter this program 
in the window marked ‘Untitled’: 


wordi = "Hello " 


word2 = "World" 
print(word1 + word2) 
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Above Python IDLE makes it easy to create programs and 
run them without having to use the command line 
Don’t forget to include the space after ‘Hello’. Choose 
File > Save As and save it as hello.py. Now press F5 on 
your keyboard to run the program. (Or choose Run > 
Run Module). It’!] display ‘Hello World’ in the Shell. 
The advantage of using Python IDLE is that you can 
inspect the program in the Shell. Enter word1, and 
you’ ll see ‘Hello’. Enter word2 and you’1I see ‘World’. 
This ability to inspect and use the variables in your 
program makes it a lot easier to experiment with 
programming and detect bugs (problems in your code). 


Python comes 
pre-installed in the 
Raspbian operating 
system and you 
can use it at the 
command line 
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Variables are all-purpose containers that you use to store data and objects 


Python has five 
standard data types: 
@ Number 

@ String 

@ List 

@ Tuple 

@ Dictionary 


You'll come 
across foo’ and 
‘bar’ a lot when 
learning to code. 
These are dummy 
placeholders and 


don't mean anything. 


They could be zig 


and zag or bim and 
bam. Nobody's 
quite sure, but it 
might be related 
to the expression 
‘fubar’ from the 
Vietnamese war. 


f you’ve created a science project or 

experiment, you may have come across 

variables. In science, a variable is any factor 
that you can control, change or measure. 

In computer programming, variables are used to store 
things in your program. They could be names, numbers, 
labels, and tags: all the stuff your program needs. 

In Python, you write the name of a variable thena 
single equals sign and the word, number or object you 
want to put in it. 

Enter this code directly into the Shell: 


1 
2 


Foo 
bar 


Remember: the variable name is on the left, and the 
thing it contains is on the right. Imagine you’ve got 
two plastic cups, and you’ve scrawled ‘foo’ on the first 
and ‘bar’ on the second. You put a number 1 in foo and 
a number 2 in bar. 

If you ever want to get the number again, you just 
look in the cup. You do this in Python by just using the 
variable name: 


Foo 
bar 


You can also print out variables by passing them 
into a print function: 


print(foo) 
print(bar) 
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Variables can also be used to contain ‘strings’. 
These are groups of letters (and other characters) 
that form words, phrases or other text. 

Creating a string variable in Python is pretty 
much the same as creating an integer, except 
you surround the text with single (' ') or double 
c™ =") quotes. 

Using double quotes makes it easier to include 
apostrophes, such as print("Don’t worry. Be 
Happy" ). This line would break after ‘Don’ if you used 
single quotes — print('Don’t worry, be happy' ) 
— so use double quotes for now. 


Why variables count 

Variables make it much easier to change parts of your 
code. Say you’ve got an excellent coding job at Nursery 
Rhymes Inc and you’ve written a classic: 


print("Polly put the kettle on") 
print("Polly put the kettle on") 
print("Polly put the kettle on") 
print("We’1l1 all have tea") 


The head of marketing comes in and says “our data 
shows that Polly isn’t trending with the millennial 
demographic.” You say “Huh!” and he barks “Change 
Poliy nO Dole. 

You now have to go through and change the variable 
in all three lines. What a downer! But what if you’d 
written thousands of lines of code and they all needed 
to change? You’d be there all week. 

With variables, you define the variable once and 
then use it in your code. Then it’s ready for changing 
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at any time: 
name = "Polly" 


print(name + " put the kettle on) 
print(name + " put the kettle on) 
print(name + " put the kettle on) 
print("We’11 all have tea") 


This code prints out the same classic nursery rhyme. 


But if you want to change the name of our character, 
you only have to change it in one place: 


name = "Dolly" 


...and the poem will update on every line. 


What's your type? 

When you create a variable in Python, it’s 
automatically assigned a type based on what it is. You 
can check this using the type() function. In the shell 
interface, enter: 


foo = "Ten 
bar = 10 


Now use the type() function to check the type of 
each variable: 


type(foo) 
type(bar) 


It willsay<class 'str'> for foo, and <class 
‘int'> for bar. This concept is important, because 
different types work together in a variety of ways, and 
they don’t always play nicely together. 

For example, if you add together two strings they 
are combined: 


name = "Harry" 
job = "Wizard" 
print("Yer a " 


+ job + + name) 

This prints the message “Yer a Wizard Harry”. The 
strings are concatenated (that’s a fancy programming 
term for ‘joined up’). Numbers, though, work 
completely differently. Let’s try a bit of maths: 


6 
9 


number1 
number2 


print(number1 + number2) 
Instead of concatenating 6 and 9 together to give 


69, Python performs a bit of maths, and you get the 
answer ‘15’. 
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Type casting 
So what happens when you want to add a string and 
an integer together? 


name = "Ben" 
number = 10 
print(name + number) 


You’ ll get an error message: ‘TypeError: Can’t 
convert 'int' object to str implicitly’. This error is 
because Python can’t add together a string and an 
integer, because they work differently. Ah, but not 
so fast! You can multiply strings and integers: 


print(name * number) 


It’ ll print ‘Ben’ ten times: you’|l get 
‘BenBenBenBenBenBenBenBenBenBen’. 

If you want to print out ‘Ben10’, you’ll need to 
convert the integer to a string. You do this using 
a str() function and putting the integer inside 
the brackets. Here we do that, and store the result 
in anew variable called number_as_ string: 


number_as_string = str(number) 
print(name + number_as_string) 


This code will print out the name ‘Ben10’. This 
concept is known as ‘type casting’: converting a 
variable from one type to another. 

You can also cast strings into integers using the 
int() function. This is particularly useful when you 
use input() to get a number from the user; the input is 
stored as a string. Let’s create a program that asks for 
a number and exponent and raises the number to the 
power of the exponent (using the ‘**’ symbol): 


number = input("Enter a number: ") 
exponent = input("Enter an exponent: ") 
result = int(number) ** int(exponent) 
ab 
Our first two variables, number and exponent, g 
are Strings, while our third, result, is an integer. 
We could just print out the result: 


print(result) 


But if we wanted to include a message, we need to 
type cast result to a String: 


print(number + 


raised to the power 
+ exponent + " is " + str(result)) 


Variables, types, and type casting can be a bit tricky at 
first. Python is a lot easier to use because it dynamically 
changes the type of a variable to match the thing you put 
in it. However, it does mean you have to be a bit careful. 


feature 


What 
to calla 
variable? 


Variable names 
should be lower- 
case words 
separated by an 
underscore ‘_’ 
They can include 
numbers, but 
must start with a 


letter. You can call 
variables pretty 


much anything, 
but there's a small 
list of reserved 
keywords you 
should avoid 
(magpi.cc/ 
2h7MH1y). It's a 
good idea to call 
them something 
that will be 
obvious when 

you use them in 
your program, like 
‘student_name’ or 
‘person_age:. 
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These comparison 
operators are 
commonly used 

in conditions 

to determine if 
something is True 
or False: 


equal 

not equal 
less than 
less than 

or equal to 
greater than 
greater than 
or equal to 
less than or 
greater than 


omputers are great because they don’t mind 
doing the same stuff over and over again. 
Their hard-working nature makes computers 
ideal for doing grunt work. 

When looking at variables earlier, we printed out 
this nursery rhyme: 


print("Polly put the kettle on") 
print("Polly put the kettle on") 
print("Polly put the kettle on") 
print("We’1l1 all have tea") 


We didn’t like the repetition of Polly, so we replaced it 
with a variable. But this code is foolish in another way: 
you have to write out the same print line three times. 


We’re going to use a loop to get rid of the repetition. 


The first loop we’re going to look at is a ‘while loop’. 

In Python 3 IDLE, create a new file and save it as 

polly.py; enter the code from the top of the next page. 
We start with two variables: 


name = "Polly" 
counter = @ 


There's a massive nerd debate about whether to use spaces or tabs when 
indenting code. There are valid arguments on both sides, which you can learn in 
this clip from HBO's comedy Silicon Valley (magpi.cc/2gZdeoM). Use spaces for 
now. When you're a hardcore coder, you can make the argument for tabs. 
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Then we use the while statement followed by a 
condition: counter < 3. 

On the next line down, you press the space bar four 
times to indent the code. Don’t press the TAB key 
(see ‘Tabs or spaces°’ boxout). 


while counter < 3: 
print(name + " put the kettle on") 
counter = counter + 1 


The < symbol stands for ‘less than’. 
It checks if the item on the left is less than the 
item on the right. In this case, it sees if the variable 
counter (which starts at 0) is less than 3. This 
condition is known as ‘True’; if it wasn’t, it’d 
be known as ‘False’. 

Finally, enter the last line of code: 


print("We’11 all have tea") 


Save and run the program (press F5). It will print 
‘Polly put the kettle on’ three times and then ‘We’1] all 
have tea’. 


While, condition and indent 
There are three things here: the while statement, the 
condition, and the indented text, organised like this: 


while condition: 
indent 


Imagine a three-way chat between all three items 
in our polly.py program: 
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While: “Hey Condition! What’s your status°” 
Condition: “True! The counter is o. It’s less than 3.” 
Indent: “OK, guys. I’ll print out ‘Polly put the kettle 
on’ and increase the counter by 1. What’s next” 


While: “Hey Condition. What’s your status°” 
Condition: “True! The counter is now 1.” 
Indent: “OK. I’m printing out another ‘Polly put 
the kettle on’ and increasing the counter by 1.” 


This goes on till the counter hits 3. 


While: “Hey Condition. What’s your status?” 
Condition: “False! The counter is now 3, which isn’t 
less than 3.” 

While: “OK guys. We’re done!” 


The program doesn’t run the indented code, but moves 
to the single print at the end: ‘We’1l all have tea’. 


For and lists 
The next type of loop is known as ‘for’. This is 
designed to work with lists. 

Lists are a type of variable that contain multiple 
items (strings, numbers, or even other variables). 
Create a list by putting items inside square brackets: 


banana_splits = ["Bingo", "Fleegle", 
"Drooper", "Snorky" | 


Now enter banana_ splits in the Shell to view the 
list. It will display the four names inside the square 
brackets. You can access each item individually using 
the variable name and square brackets. Enter: 


banana_splits[@] 


...and you’ ll get ‘Bingo’. Lists in Python are zero- 
indexed; that means the first item in the list is [o]. 
Here are each of the items. Type them into the Shell 
to get the names returned: 


2 i . 
4% 
y | 
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name = "Polly" 
counter = 9 


while counter < 3: 
print(name + " put the kettle on") 


counter = counter + 1 


print("We’11 all have tea") 


banana_splits[0] # "Bingo" 
banana_splits[1] # "Fleegle" 
banana_splits[2] # "Drooper" 
banana_splits[3] # "Snorky" 


Zero-indexed lists can be confusing at first. Just 
remember that you’re counting from o. A for loop 
makes it easy to iterate over items ina list. Create 
this program and save it as splits.py: 


banana_splits = ["Bingo", "Fleegle", 
“Drooper", "Snorky" | 


for banana_split in banana_splits: 
print(banana_split) 


It doesn’t matter what you use as the variable in 
a for loop, as long as you remember to use it in your 
indented code. You could put: 


for dude in banana_splits: 
print (dude) 


It?s common to name the list as something plural 
(such as ‘names’, ‘pages’, and ‘items’) and use the 


singular version without the ‘s’ for the ‘in’ variable: 


‘for name in names’, ‘for page in pages’, and so on. 


You must be 
careful to change 
the counter in 

a While loop, 

or you'll get an 
infinite loop. If 
you delete the 
line counter = 
counter + 1 
from our while 
loop, it will run 
forever: it never 
goes above 0, 

so the indented 
code runs over 
and over again. 
This bug is known 
as an infinite 
loop’ and is a bad 
thing to have in 
your programs. 
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You can combine 
conditions together 
using logical 
operators. 


and_ Both operands 
are true: (a and 
b) is True 
Any operator is 
true: (a or b) is 
True 
Checks if 
something is 
false: not (a 
and b) is True 
if both a and b 
are False. 


our programs have been slowly getting more 
powerful. We’ve learned to run instructions 
in procedural order, replaced parts of our 
program with variables, and looped over the code. 

But another important part of programming is 
called ‘conditional branching’. Branching is where a 
program decides whether to do something or not. 

Of course, a program doesn’t just decide whether or 
not to do things on a whim: we use the sturdy world of 
oie Ines 

The start of all this is the powerful ‘if’ statement. 

It looks similar to a loop, but runs just once. The if 
statement asks if a condition is True. If it is, then it 
runs the indented code: 


if True: 
print("Hello World") 


Run this program, and it’ll display ‘Hello World’. 
Now change the if statement to False: 


if False: 
print("Hello World") 


...and nothing will happen. 

Of course, you can’t just write True and False. 
Instead, you create a condition which evaluates to 
True or False; a common one is the equals sign (==). 
This checks whether both items on either side are 
the same. Create a new file and enter the code from 
password1.py. This code is a simple program that 
asks you to enter a password; if you enter the correct 
password, ‘qwerty’, it displays ‘Welcome’. 
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Be careful not to confuse the equals logic operator 
== with the single equals sign =. While the double 
equals sign checks that both sides are the same, 
the single equals sign makes both sides the same. 
Getting == and = mixed up is acommon mistake for 
rookie coders. 


What else 


After if, the next conditional branch control you need 
to learn is ‘else’. This command is a companion to if 
and runs as an alternative version. When the if branch 
is True, it runs; when the if branch is False, the else 
branch runs. 


if True: 

print("The first branch ran") 
else: 

print("The second branch ran") 


Run this program and you’ll see ‘The first branch 
ran’. But change True to False: 


if False: 

print("The first branch ran") 
else: 

print("The second branch ran") 


...and you’ll see ‘The second branch ran’. Let’s use 
this to expand our password program. Enter the code 
from password2.py. 

Run the program again. If you get the password 
correct now, you’ll get a welcome message. Otherwise, 
you’ ll get an ‘incorrect password’ message. 
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Elif 

The third branching statement you need to know 

is ‘elif’. This statement stands for ‘else if’, and sits 
Es ) 

between the if and else statements. Let’s look at an if attempt 

elif statement. Enter this code: 


password = “qwerty” 
attempt = input("Enter password: ") 


== password: 
print( "Welcome" ) 


if False: 

print("The first block of code ran") 
elif True: 

print("The second block of code ran") 


password = “qwerty” 
attempt = input("Enter password: ") 


else: 
print("The third block of code ran") if attempt == password: 
print( "Welcome" ) 
else: 


Run this program and you’ ll find it skips the first if 
statement, but runs the elif statement. You’ get ‘The 
second block of code ran’. 

The else statement doesn’t have a True or False 


print("Incorrect password!") 


condition; it runs so long as neither the if or elif Writing FizzBuzz 
statements are True. (Note that the else statement here, The brief for our FizzBuzz is to print the numbers from 1 to Comments 
as always, is optional; you can just have if and elif.) 100. If anumber is divisible by three (such as 3, 6, and 9), 

But what happens if you change both the if and elif then you print ‘Fizz’ instead of the number; if the number Amark of a good 
conditions to True? Give it a try and see whether just is divisible by five, you print ‘Buzz’ instead. programmer is to 
if runs, or elif, or both. Experiment with removing the But if a number is divisible by both 3 and 5, such as Hee COMneniCin 
else statement and play around. It’ll help you get the the number 15, then you print ‘FizzBuzz’. your programs. 
hang of the if, elif, and else statements. We’re also introducing a new element in FizzBuzz: Comments nic 

: the ‘and’ statement. This checks if two conditions used to explain 
FizzBuzz are both True: that the number can be divided by bits of your 
We’ re going to show you a common program used both 3 and 5. It only returns True if both conditions program to 
in computer programming interviews. It’s a classic aide [icUlS humans. They 
called ‘FizzBuzz’, and it shows that you understand if, There are three main logical operators: and, or, are completely 
else, and elif statements. and not. The first two are relatively straightforward, ignored by 

First, you need to know about the modulo operator but the ‘not’ operator can be more confusing at first. the computer. 
(%). This is used to get the remainder from a division Don’t worry about it too much; you’!] get the hang of In Python, you 
and is similar to a divide operator. Take this function: it with practice. eta caninnent 

Enter the fizzbuzz.py code from page 83 to practise Toe eee 

10 / 4 == 2.5 using if, else, and elif elements and logical operators. 


symbol (#). It can 


be ona line on 


If we use a modulo instead, we get this: it own, orit can 


come right after 
10 % 4 == a line of code. As 


soon as Python 
Modulo turns out to be handy in lots of ways. You hits the # it'll 


: , 
can use% 2 to figure out if a number is odd or even: stop translating 


whatever follows 
10 % 2 == © # this is even 


11 % 2 == 1 # this is odd 


into machine code. 
Comments help 
other users to read 
your program, but 
they will also help 


This program works out if a number is odd or even: 


number = 10 you understand 


what you're doing 
if number % 2 == 


print("The number is even") 
else: 


(long after you've 


forgotten). It's 


a good habit to 
print("The number is odd") Beere Oriente ii 
your programs. 
OK -— let’s move on to FizzBuzz. 
—— 
—, 
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Create the building blocks of code and make more robust programs 


ou’ve come a long way since your first 
‘Hello World’. Your programs now check 
for conditions and loop over themselves. 

You’re now writing programs that are known as 
‘Turing complete’, named after Alan Turing, the father 
of computer science and artificial intelligence, who 
hacked the German Enigma code in WWIL. 

Now we’re going to take things a little further. 
We’re going to introduce you to a form of modularity 
called functions. 

Functions are blocks of code that you write once 
and can repeat anywhere. It’s a little like being able to 
write a block of text once, and then paste it whenever 
you need it. 


Spotting a function 

Python is packed with built-in functions, 
and you’ve already been using them in your 
programs. Commands like print(), len(), and 

type() are all functions. They’re easy to spot: a 

small command Starting with a lower-case letter 
and followed by a pair of parentheses ‘()’. 


You can browse or download a copy of the Python 
documentation directly from the Python website 

at python.org/doc. Python has a whole bunch of 
built-in functions. You can view a list of all the built-in 
functions on the Python documentation website 
(magpi.cc/2gPsGkK3). 
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Using functions 
Let’s take a look at a function called abs(). It stands 
for ‘absolute’, and returns the absolute value of any 
number you pass into it (the bit you pass in is called 
the ‘argument?’). 

An absolute number is the positive of any number, so 
if you write abs(-2) you get 2 back. Try this in the Shell: 


abs(2) # returns 2 
abs(-2) # returns 2 


You can store the returned result as a variable: 
positive _number = abs(-10) 


We find it easier to read a function backwards, from 
right to left. The value is passed into the parentheses, 
then the function cranks it and returns a new value. 
This is passed left and stored into the variable. 


Defining a function 

The great thing about Python is that you don’t just 
use the built-in functions: you get to make your own. 
These are called ‘user-defined functions’. 

You create a function using the def keyword, 
followed by the function name and parentheses. 
Inside the parentheses, you list the parameters. 
These are the same as the arguments, only inside the 
definition they are called ‘parameters’. 


def function(parameter): 
return parameter 
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Our function here doesn’t do anything; it simply 
accepts a parameter and returns it. 

At the end of the function definition is a colon (:). 
The function code is indented by four spaces, just like 
a loop or if/else branch. 

The code inside the indentation runs when you call 
the function. Functions typically include a return 
statement which passes back an expression. 


Working functions 
We’re going to create a function that prints the lyrics 
to Happy Birthday. 

Type out the happy_birthday. py code from the 
histing, then rum ithe Sell emter 


happy_birthday("Lucy" ) 


This function call uses the string ‘Lucy’ as the 
argument. This string is passed into the function as 
the parameter and is then available for use in the 
indented code inside the function. 


Return statements 
Many functions don’t just run a block of code; they 
also return something to the function call. 
We saw this in abs(), which returned the absolute 
value of a number. This can be stored in a variable. 
In fact, we’re going to recreate the abs() function, 
so you can see how it’s working behind the scenes. 
In maths, you invert a positive/negative value by 
multiplying a negative number by ~1, like this: 


10 * -1 = -10 
-10 * -1 = 10 


We need to create a function that takes a number 
as a parameter and checks if it’s negative. If so, it 
multiplies it by -1; if it’s positive, it simply returns the 
number. We’re going to call our function absolute(). 

Enter the code in absolute.py. When the function 
hits either of the return statements, it returns the 
value of the number (either on its own or multiplied 
by -1). It then exits the function. 

Run the absolute. py code and enter the following 
in the Shell: 


absolute(10) 
absolute(-10) 


Our last program listing is a classic known as 
‘FizzBuzz’; as mentioned on page 81, it will help you 
to understand if, else, and elif. 

You also need to know the modulo operator (%) for 
FizzBuzz. This operator returns the remainder from a 
division. If you don’t know how modulo works, watch 
this video (magpi.cc/2h5XNRO). 

Now work through the code in fizzbuzz.py. 
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def happy_birthday(name): 


happy birthday. py 


count = @ 
while count < 4: 
if count != 2: 
print("Happy birthday to you") 
else: 


+ name) 


print("Happy birthday dear 
count += 1 


def absolute(number): 
if number < 0: 
return number * -1 
else: 
return number 


count = @ 
end = 100 fizzbuzz.py 
while count <= end: 
if count % 5 == © and count % 3 == @: 
print("FizzBuzz" ) 
elif count % 3 == @: 
print("Fizz") 
elif count % 5 == 
print("Buzz") 
else: 
print(count) 


count += 1 


Here are some resources you will find useful. 


GPIO Zero Essentials — magpi.cc/2bA3ZP7 

This Essentials guide book explains how the GPIO Zero Python module 
provides access to a bunch of features. These are used to hook up 
electronics to your Raspberry Pi via the GPIO pins. 


FutureLearn - magpi.cc/2h5Sthf 

The Raspberry Pi Foundation has two new online training courses: 
Teaching Physical Computing with Raspberry Pi and Python, and 
Teaching Programming in Primary Schools. 


Learning Python - magpi.cce/2h20pWC 
This tutorial provided by The Raspberry Pi Foundation 
has files you can download. You download the file, 


called intro.py, using this command in a Terminal: 
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Te 


We 


wget http://goo.gl/@ZDOdX -O intro.py 
--no-check-certificate. Open 

the intro.py file in IDLE; all the 

instructions are in the file. 


Importing 


Stand on the shoulders of giants by importing 
other programmers’ code 


Pygame 


If you want to 

learn more about 
Pygame, check out 
Make Games With 
Python, our free 
Essentials Guide to 


the Pygame module. 
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his being the modern world, you’re not 
supposed to do all the work on your 

own. Instead, you will often stand on the 
shoulders of other programmers who have done the 
eroundwork for you. 

Your programs can import code created by other 
people using the import statement. This enables 
you to import modules and use their functions — only 
they’re now known as ‘methods’. 

You import the module at the command line, and 
then access the functions using dot notation. This is 
where you list the module, followed by a dot (.), then 
the method. 

A common module to use is math. This allows you 
to access lots of maths methods. Open a Python Shell 
and enter: 


import math 


You now have access to all the methods in math. 
You won’t notice any difference, but if you type: 


type(math) 
...it will say ‘<class 'module'>’. Let’s try out dot 
notation now. Type math followed by a dot and the 
name of the method (function) you want to use: 

math.sqrt(16) 

This gives the square root of 16, which is 4. 


Some methods have more than one argument. The 
math. pow() method raises a number to an exponent: 
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math. pow(64, 3) 


This returns 262144.0. 

You can also access constant values from a module, 
which are fixed variables contained in the module. 
These are like functions/methods, but without 
the parentheses. 


math.pi 


This returns pi to 15 decimal spaces: 
3.141592653589793. 


math.e 


This returns Euler’s number to 15 decimal spaces: 
2.718281828459045. 

It’s also possible to import methods and constants 
from modules using from. This enables you to use 
them inside your programs without dot notation 
(like regular functions). For example: 


from math import pi 
from math import e 
from math import pow 


Now, whenever you type pi or e, you’1l get pi and 
Euler’s number. You can also use pow() just like a 
regular function. You can change the name of the 
function as you import it with as: 


from math import pi as p 


Now when you enter p you’ ll get pi to 15 decimal 
spaces. Don’t go crazy renaming functions with as, 
but it’s common to see some methods and constants 
imported as single letters. 

By creating your own functions, and importing 
those created by other people in modules, you can 
vastly improve the capabilities of your programs. 

We’re going to take everything we’ve learnt and use 
it to create a game of Pong; this is one of the world’s 
first videogames. 

Write out the code carefully in pong.py. Here you’ll 
find variables, functions, loops, and conditional 
branching: all the stuff we’ve talked about. Hopefully, 
you'll now be able to decipher most of this code. 

If you’re interested in taking Pong further, this 
program is similar to a version of a Pygame program 
by Trever Appleton (magpi.cc/2hgkOUX). His version 
has a scorecard and more advanced code. We’ve kept 
ours simple so it’s easier to start with. 

Hopefully this isn’t the end of your Python, or 
programming, journey. There are lots of places you 
can learn programming from. And you can find 
more programming resources for you in every issue 
of The MagPi (magpi.cc). 
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. import pygame, sys 


Q@2. from pygame.locals import * 

03. 

Q@4. # Set up game variables 

@5. window_width = 400 

Q6. window_height = 300 

Q@7. line_thickness = 10 

Q8. paddle size = 50 # try making this smaller for a harder game 

Q9. paddle offset = 20 

10. 

11. # Set up colour variables 

12. black = (@ ,@ ,@ ) # variables inside brackets are ‘tuples' 

13. white = (255,255,255) # tuples are like lists but the values don't 
change 

14. 


. # Ball variables (x, y Cartesian coordinates) 

. # Start position middle of horizontal and vertical arena 
. ballX = window_width/2 - line_thickness/2 

. ballY = window_height/2 - line_thickness/2 


. # Variables to track ball direction 


21. ballDirX = -1 ## -1 = left 1 = right 

22. ballDirY = -1 ## -1 = up 1 = down 

2% 

24. # Starting position in middle of game arena 

25. playerOnePosition = (window_height - paddle size) /2 
26. playerTwoPosition = (window_height - paddle size) /2 
27 

28. # Create rectangles for ball and paddles 


. paddle1 = pygame.Rect(paddle_offset,playerOnePosition, line_ 
thickness, paddle size) 

. paddle2 = pygame.Rect(window_width - paddle offset - line_ 
thickness, playerTwoPosition, line_thickness, paddle_size) 


31. ball = pygame.Rect(bal1X, ballY, line_thickness, line_thickness) 
BZ 

33. # Function to draw the arena 

34. def drawArena(): 

a5. screen. fill((0,0,0)) 

36. # Draw outline of arena 

37 i pygame.draw.rect(screen, white, ( 


(0,2), (window_width,window_height)), line _thickness*2) 

# Draw centre line 

pygame.draw.line(screen, white, ( 
(int(window_width/2)),®),((int(window_width/2)),window_ height), ( 
int(line_thickness/4) )) 


. # Function to draw the paddles 


42. def drawPaddle(paddle): 

43. # Stop the paddle moving too low 

44. if paddle.bottom > window_height - line thickness: 
45. paddle.bottom = window_height- line_thickness 
46. # Stop the paddle moving too high 

47. elif paddle.top < line_thickness: 

48. paddle.top = line_thickness 

49, # Draws paddle 

58. pygame.draw.rect(screen, white, paddle) 

51. 

52. # Function to draw the ball 

53. def drawBall(ball): 

54. pygame.draw.rect(screen, white, ball) 

55. 

56. # Function to move the ball 

57. def moveBall(ball, ballDirX, ballDirY): 

56. ball.x += ballDirXx 

5 ball.y += ballDirY 

60. return ball # returns new position 

61 

62. # Function checks for collision with wall and changes ball 


direction 
. def checkEdgeCollision(ball, ballDirX, ballDirY): 


if ball.top == (line_thickness) or ball.bottom == (window_ 
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62s 
66. 


67. 
68. 
62, 
70; 
Fis 
72; 


Ts 
74. 


75% 
76; 
ee 
13. 
Fo. 
80. 
Ol. 
82. 
G3. 
84. 
85. 
3G; 
87. 
88. 
89. 
90. 
1, 
D2. 
93. 
94. 
= he ae 
96. 
ays 
OS: 
39. 


100. 
101. 
102. 
103. 
104. 
105. 
106. 
107. 
108. 
109. 
110. 
111. 
112. 
113. 
114. 
115» 
116. 
117. 
118. 
119, 
120. 
121. 
i22. 
123. 
124. 
2s 


126. 


127. 


128. 
129. 


height - line thickness): 
ballDirY = ballDirY * -1 
if ball.left == (line_thickness) or ball. 
right == (window_width - line_thickness): 
ballDirX = ballDirx * -1 
return ballDirX, ballDirY # return new direction 


Pong-py 


# Function checks if ball has hit paddle 
def checkHitBall(ball, paddle1, paddle2, ballDirX): 
if ballDirX == -1 and paddlei.right == ball.left and 
paddle1.top < ball.top and paddle1.bottom > ball.bottom: 
return -1 # return new direction (right) 
elif ballDirX == 1 and paddle2.left == ball.right and 
paddle2.top < ball.top and paddle2.bottom > ball.bottom: 
return -1 # return new direction (right) 
else: 
return 1 # return new direction (left) 


# Function for AI of computer player 
def artificialIntelligence(ball, ballDirX, paddle2): 
# Ball is moving away from paddle, move bat to centre 
if ballDirX == -1: 
if paddle2.centery < (window_height/2): 
paddle2.y += 1 
elif paddle2.centery > (window_height/2): 
paddle2.y -= 1 
# Ball moving towards bat, track its movement 
elif ballDirX == 1: 
if paddle2.centery < ball.centery: 
paddle2.y += 1 
else: 
paddle2.y -=1 
return paddle2 


# Initialise the window 
screen = pygame.display.set_mode((window_width,window_height) ) 
pygame.display.set_caption('Pong') # Displays in the window 


# Draw the arena and paddles 
drawArena() 
drawPaddle(paddle1) 
drawPaddle(paddle2) 

drawBall (ball) 


# Make cursor invisible 
pygame.mouse.set_visible(@) 


# Main game runs in this loop 
while True: # infinite loop. Press Ctrl-C to quit game 
for event in pygame.event.get(): 
if event.type == QUIT: 
pygame.quit() 
sys.exit() 
# Mouse movement 
elif event.type == MOUSEMOTION: 
mousex, mousey = event.pos 
paddlei.y = mousey 


drawArena() 
drawPaddle(paddle1) 
drawPaddle(paddle2) 
drawBall(bal1) 


ball = moveBall(ball, ballDirX, ballDirY) 
ballDirX, ballDirY = checkEdgeCollision( 
ball, ballDirX, ballDirY) 
bal1DirX = ballDirX * checkHitBall( 
ball, paddle1, paddle2, ballDirX) 
paddle2 = artificialIntelligence (ball, ballDirX, paddle2) 
pygame.display.update() 
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Get your head around OOP by using Scratch and Python to create the same programs 
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UNDERSTAND OBJECT-ORIENTED PROGRAMMING 


n the modern world, almost all of the 
code you will encounter is created 

in a style called ‘object-oriented 
programming’, or OOP for short. 

If you grew up with OOP, it is the obvious 
way to create computer programs. 

IMOOP tie cede isiisedite crear ob )|cets. 
These represent real-world things: a dog, a 
chair, or the wheels on a car. 

Objects contain both the variables that 
make that thing: a person’s height, age, or 
a name for example. They also contain the 
functions that object can perform: a dog can 
jump, or walk, or run; a wheel can rotate. 

OOP bundles both the variables and 
functions together. This style makes it 
super-easy to cut and paste the code from one 
program to another. You don’t even need to cut 
and paste, in fact: you use import statements to 
get functions and the variables they need. 

With OOP, you don’t need to create an object for 
a dog: you just find one somebody else has made 
and import it to your program. 


Importing knowledge 

At the start of most programs, you’ll find a bunch of 
import statements. These are used to paste in code 
which has been created by other people. 


OOP isn’t perfect. It can be accused of overkill. “The 
problem with object-oriented languages is they’ve got 


all this implicit environment that they carry around 
with them,” says Joe Armstrong, creator of Erlang. 
“You wanted a banana but what you got was a gorilla 
holding the banana, and the entire jungle.” 

There’s also a whole bunch of decorative 
terminology surrounding OOP. You’1l encounter 
lots of strange words like ‘encapsulation’ and 
‘instantiation’. These make the concept appear much 
more complicated than it is, and can also be rather 
off-putting to newcomers. 

So OOP is a bit wordy and lends itself to navel- 
gazing. Many makers, hackers, and coders struggle to 
understand OOP, and indeed you can get a long way 
without understanding it. 

Young coders, on the other hand, are increasingly 
introduced to programming via Scratch. 

Software like Scratch is included with Raspbian on 
a Raspberry Pi, and it is designed specifically to teach 
students OOP stealthily. 

In Scratch, objects are called ‘Sprites’. They 
resemble video game characters. The idea is that 
children brought up on Scratch will inherently 
feel at home with objects when they migrate toa 
language like Python. 
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PROCEDURE 


When you first start programming, you'll begin by 
writing procedural code. 

In good old-fashioned procedural programming, 
you typically create all your variables at the start of a 
program. Then you make some function definitions 
(these are blocks of reusable code). 

We looked at procedural programming in Beginner's 
guide to coding (page 72). 

OOP takes all the building blocks of procedural 
programming - variables, functions, loops, conditions — 
but bundles them into self-contained blocks. 

Most coders create procedural scripts that import 
objects (from modules and packages). So you're using 
objects without even realising it. 

OOP concepts are found in almost all modern 
programming languages, including Python and Java. 
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CREATE 
INS! 


Create a game in Scratch where players play 


dice with one another 


Raspbian 


Scratch online 


irst, we’re going to create a game in 
Scratch. Then we’ll recreate it in Python so 
you can see how it works in both languages. 

Our dice game is based on Bunco 
(magpi.cc/2hoZNcj). It’s a popular parlour game 
played in North America. 

We’ve made the rules a little simpler. Each player 
rolls three dice and counts up the score. The player 
with the highest score wins. 

We need two players, each with their own set 
of dice. Each player then rolls the dice, looks at 
their dice, and compares them with the dice of 
the other player. 

If they have the same score, both call it a draw. 

If a player spots that their total is higher than the 
other person’s, they shout out “I win!”’. 

This game introduces you to the concept 
of local variables. Each sprite has three local 
variables: their own set of dice. They can also 
look at the variables (or dice) that are local to 
other sprites. 

The opposite of a local variable is a global 
variable. This is as if both players rolled a single set 
of dice and shared the result. They’d always draw. 

Scratch works slightly differently to Python. 

In Scratch, you create one sprite and then clone 
(duplicate) it to create a second sprite. In Python, 
you create a blueprint for your sprites (known as 
a ‘class’) and then stamp out two player objects. 
We'll come to Python in a bit. 

Let’s create the dice game in Scratch first... 
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>STEP-O1 

Scratch 

Open the web browser and visit scratch.mit.edu to 
open Scratch 2.0. We need the clone features from 
2.0, so don’t use the Scratch 1.4 app. Log in (or create 
an account if you’re new to Scratch). Create a new 
project and you’ll see a single Scratch Cat sprite on the 
screen. Click the ‘i’ symbol next to the sprite in the 
bottom-left. Change its name to Player1. 


>STEP-02 


Three dice 

Click on Data and then Make a Variable. Enter dice1 
in the Variable name field and select ‘For this sprite 
only’. Click OK and dice1 appears in the blocks 
palette. Repeat the process to create dice2 and dice3. 
Finally, create another variable called total. 
Remember to choose ‘For this sprite only’ for all 
meee Ge sinal vowalll, 
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Bunco on Scratch = \\) & 
© CS | @ hitps //seratch mit. edu/ projects 3753.4390/ "editor ear BG : 


>STEP-05 

Compare scores 

We've only got one sprite so far. But we’re about to 
add another and compare one sprite’s total with the 
other. Choose the Sensing selection of blocks and 
look for one marked x-position of Player1. Change 
‘x-position’ to total. Drag the block into the correct 
side of the greater-than block. 


© Foralsprtes @ For thts sprte on 


yl ™= clicked ws 


FIOy 0 

= | sy) 4 

ere bet diced 
dices oO 


Throw the dice pick random @ to @ 
Click on Events and drag a when green flag clicked 


: | 
block to the scripts area. Below this you need to 


add three set diceN to pick random 1 to 6 blocks. — “total for @} secs 
Below these blocks, add set total to dice1 + dice2 
+ dice3 (you need to drag one () + () block inside 
another to add up three blocks. 


clicked 
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>STEP-06 
Player 2 

Our Player 1 is ready. Now we’re going to clone the sprite 
to create a Player 2. Right-click the sprite and choose 
Duplicate. The new cat sprite will be automatically called 
‘Player2’. Click on Player1 in the Sprites window. Change 
the total of Player1 block to total of Player2 (as shown 
below). Now Player1 compares their total to Player2 (and 
Player2 is comparing theirs to Player1). Click the green 
flag to run the program and see which player wins. 


iced to. pick random @ to @ 


>STEP-04 


Speak 7's tenco.on Serstch, x \ ih : — a 
Now drag a say for block and attach it to the end of no a EY 
the code. Change it to say total for 1 secs. Below Be) roonatasey ers E 
that, drag an if block. Inside, add a [] > [] (greater- 
than) block. Drag the total variable to the left side of 
the greater-than block. Drag a say block inside the if OY 
block and change ‘Hello!’ to ‘I win’. ee KR 
Oo wey ae 


New sprite: ¢/aa 


= 
WY 
pick random @ to 


Oo 
0 
6 


The concept of scope is important in object-oriented programming. In Scratch, it’s 


so simple that you may not even notice it. But our two players each have their own 
dice1, dice2, and dice3 variables, plus a total variable. These variables are local in 
scope. When Player1 announces total, it’s their total. If both sprites accessed the 
same total, it would be global in scope. Variables in objects are local in scope. 
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AND INSTANCE 


One of the biggest differences between creating sprites in Scratch and 
objects in Python is that you create an object using a class. This code acts 
as a blueprint for the object. 

In Scratch, you create a sprite and then duplicate it. The second sprite has 
the same functions as the first. It also has its own set of variables. 

In Python (and other programming languages), things work somewhat 
differently. You don't create an object directly. Instead, you create a blueprint 
for the objects. This blueprint is known as the ‘class: Don't think of a school, 
though. Class here means a category of similar items. It's rather like a ‘Class M 
planet in Star Trek: though different, these are all Earth-like planets. 

Once you've created your class, you use it to create objects. 

These are known as ‘instances’ or ‘object instances’ They all share 
similar properties. They all have the same variables and functions 
(called ‘methods’). In Scratch, we create one sprite and then duplicate 
it (to get two sprites). In Python, we create one class definition. We then 
use this to create two object instances. 
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Recreate our game of Bunco in Python 


ur basic version of Bunco runs just fine in 
Scratch. Now we’re going to recreate it in 
Python. The translation will help us get a good 
understanding of how objects work. 

First, think about how we could make the 
game procedurally. 

There is a module called random that we can import 
to create random numbers. So we’d need to import 
that. Then we could create a list for each player. 

And use the randint function to add three random 
numbers between one and Six. 

We could then use an if else block with the sum() 
function to add up each player’s numbers. The player 
with the highest score wins. 

Type out the code from bunco_procedural.py to test 
the program. 

There are two problems with this procedural. 
Bunco is a much more complex game in real life. 

It is played in six rounds, and players score 21 points 
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if they roll all three dice that match the number of {a ' g 
the round (three 1s in round 1, or three 2s in round 2, b ocedural >PYTHON 
and so on). That’s known as rolling a ‘bunco’. unco_pr -PYy 


We’re not going to create all that complexity here. DOWNLOAD: 
But we are going to add extra types of player. Cheats! import random MaOPICC/2XEOW. 
One scoundrel has loaded dice; the other rapscallion 
Swaps out one die for a Six. player1 dice = [] 

We’re then going to play thousands of games and player2_dice = [] 
see who wins. 

This complexity would be extremely difficult in for i in range(3): 
procedural programming. It requires us to rethink our player1_dice.append(random.randint(1,6)) 
approach to Bunco. And OOP is the answer. player2_dice.append(random.randint(1,6)) 

OOPs upside your head print("Player 1 rolled" + str(player1_dice)) 


print("Player 2 rolled" + str(player2_dice) ) 


Instead of creating a list of variables for each player at 


the start, we’re going to create a class called Player. if sum(player1 dice) == sum(player2_ dice): 
The code in bunco_oop.py represents a dice player. print( "Draw" ) 
We then use it to create two players (see ‘Class elif sum(player1_dice) > sum(player2_ dice): 
and Instance’). print("Player 1 wins") 
As with our procedural code, we start by importing else: 
the randint module. print("Player 2 wins") 


Now we define our player objects. To do this, 
we create a class definition. It looks like this: 


class Player: bunco_ocop.py 


Inside the class definition is indented code that from random import randint 
describes the player object. 
Notice that the class name is capitalised and, unlike class Player: 
function definitions, there are no parentheses. def _init (self): 
The first thing we need to add is a list to contain the self.dice = [] 
dice. Normally this would be just dice = []. But if we 
wrote it like this: def roll(self): 
self.dice = [] # clears current dice 
Class Player: for i in range(3): 
dice = [] self.dice.append(randint(1,6) ) 
...we’d have a problem. This code is equivalent to def get dice(self): 
choosing ‘For all sprites’ in Scratch. Every player return self.dice 
created using this code would share a single set of 
dice and get the same results. We want to use the player1 = Player() 
equivalent of ‘For this sprite only’. player2 = Player() 
To ensure that all our players have their own set of 
dice, we need to wrap the dice = [] list inside a quirky playeri1.roll() 
function called __init__(). player2.roll1() 


It looks like this: 
print("Player 1 rolled" + str(player1.get_dice())) 


class Player: print("Player 2 rolled" + str(player2.get_dice())) 
def init _ (self): 
self.dice = [] if sum(playeri1.get_dice()) == sum(player2.get_dice()): 
print("Draw!") 

The __init__() function runs when you use a class elif sum(player1.get dice()) > sum(player2.get_dice()): 
to create an object. print("Player 1 wins!") 

This is known as a ‘constructor’ or ‘initialiser’. else: 

Later on, when we use this Player class to create print( "Player 2 wins!") 


player objects, the ___init__() code runs each time 
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automatically. It creates a separate set of dice for each of An object’s functions are called ‘methods’, but they 


our players. are created in the same way. 

The ‘self’ bit also needs explaining. Variables, like There are lots of different types of methods, and you 
our dice = [] list are normally disposed of when a can create whatever you like, but common ones are 
function ends (or is returned). called ‘setters’ and ‘getters’. 

So if we just put dice = [], the list would be created Our roll method is a ‘setter’. It sets the dice list to 
by __init__(), then immediately vanish. three random numbers. 

Python gets around this problem using the keyword What do you think a ‘getter’ does? That’s right. It 
‘self’. You put ‘self’ inside the parentheses of the gets the variables inside the object and returns them. 
__init_ (): We have just the one getter: 

def init (self) def get_dice(self): 


return self.dice 
Then we use self, followed by a dot, to store the 


variable in this version of the object. Getters and setters seem a bit odd at first. After 
all, you could just reach into an object and access 
self.dice = [] the variables. 
Well, you could, at least in Python, but this is 
You then use self. in functions when you want to considered a bad thing to do. One of the points of OOP 
access or change a variable, by writing self insidethe _ is that objects contain their variables and keep them 
parentheses of the function. Like this: safe from other objects. So you don’t just reach inside 
an object and access variables. 
def roll(self): Instead, you create methods (functions) that set the 
variables and get them. Then you use these methods 
The concept can be mind-boggling (it’s passing a to set and get variables. 
version of itself into itself). So focus on the practical Now we’ ve created our class definition, we can use it 
steps rather than the esoteric theory of how it works: to create objects. 
e Put aspecial function at the start of a class called 
° Put the variables you want to use inside init. You create objects just as you would a variable. You 
use the assigns operator (=). We’re going to create two 
° Create the variables with self., like self.name dice players: 
or self.age or self.dice = []. 
playeri = Player() 
° Place self inside the parentheses of functions that player2 = Player() 


need to access the variables. 
Note that player1 and player2 are not called 


° Use self. and the name of the variable inside ‘variables’. They are called ‘object instances’. 
the function to use it. We access the object instance’s methods using dot 
notation. That is where you use the name of the object 
Got that? Don’t worry too much if it seems weird. instance, followed by a dot, then the name of the 
That’s the hardest part and it will get easier with practice. method you want to use. 
Now we’ ve got our dice list sorted, what about the We created a method, get_dice(), that returns 
other functions? the dice stored. We would access this method using 


: dot notation, such as playeri1.get_dice(). 
Methods in the madness First, we use the roll method to get each player 


object to roll its dice: 


Now that our class has a list for the dice, we need 


to roll the dice. For that, we’ll create a more regular player1.rol1l1() 
function definition. player2.roll1() 
def roll(self): The rest of our bunco_oop.py program is really 
dice = [] # clears any current dice very similar to bunco_procedural.py. The difference 
for i in range(3): is that here we use the .get_dice() method in 
self .dice.append(randint(1,6) ) place of sum(). 
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Inheritance cheats 


We’ve already mentioned that one advantage of OOP 
is that we can create hundreds or thousands of players 
with their own set of variables. 

There’s little point in our program as it is, as 
the players are all using the same dice and have the 
same chance of winning. What would happen if we 
introduced some cheats? 

We’re going to create a cheat who swaps out one die 
for a Six, The blighter. 

Our cheat is not alone. We have another one who 
uses three loaded dice. They always roll one higher 
(unless they’re already a six). 

Both cheats would beat a regular player over a few 
hundred games. But which of the cheats would win 
against the other? 

It’s pretty close. To find out the answer, we’ll 
need to run a Simulation that plays hundreds of 
thousands of games. 

We’re going to create our cheats using a technique 
called inheritance. This technique is where you create 


But which cheat 
would win against 
the other? 


a class that takes on all the properties (instance 
variables and methods) of another class. It also adds 
a few of its own. 

Think of a child inheriting its parents’ features. 

It might get its dad’s big nose but grow knobbly knees 
all by itself. 

Our cheats will inherit the same dice and roll 
functions as the parent, but they will have cheat 
functions all of their own. 

Our bunco_module.py program defines the 
Player() class and two children: 


class Player: 
class Cheat_Swapper(Player): 
class Cheat_Loaded_ Dice(Player): 


-bunco_module.py 


from random import randint 


class Player: 
def init (self): 
self.dice = [] 


def roll(self): 
self.dice = [] # clears current dice 
for i in range(3): 
self.dice.append(randint(1,6)) 


def get dice(self): 
return self.dice 


class Cheat_Swapper(Player): 
def cheat(self): 
self.dice[-1] = 6 


class Cheat_Loaded Dice(Player): 
def cheat(self): 
sb, 
while i < len(self.dice): 
if self.dice[i] < 6: 
self.dice[i] += 1 
i += 1 


bunco_single_test.py 


from bunco_ module import Player 
from bunco_ module import Cheat_Swapper 
from bunco module import Cheat Loaded Dice 


cheater1 = Cheat_Swapper() 
cheater2 = Cheat_Loaded Dice() 


cheater1.roll() 
cheater2.roll() 


cheater1.cheat() 
cheater2.cheat() 


print("Cheater 1 rolled" + str(cheater1.get_ dice())) 
Objects that inherit from a parent are defined using print("Cheater 2 rolled" + str(cheater2.get_dice())) 
the same class keyword. 

However, the name of the parent is placed inside 
parentheses of the child. 

Our two cheats inherit all the variables and methods 
(functions) from the parent. So they already have a 
dice list and rol1() and get_dice() methods. 

We now give each cheat an additional method, 
called cheat. This is implemented in a different way 
for each type of cheat. 


if sum(cheater1.get_dice()) == sum(cheater2.get_dice()): 
print("Draw!") 


elif sum(cheater1.get dice()) > sum(cheater2.get_ dice()): 
print("Cheater 1 wins!") 


else: 
print("Cheater 2 wins!") 
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The Cheat_Swapper class definition has a relatively 
straightforward cheat method: 


class Cheat_Swapper(Player): 
def cheat(self): 
self.dice[-1] = 6 


Cheat_Swapper’s cheat method finds the last item 
in the dice list and sets it to 6. 

Our Cheat_Loaded_Dice class definition has a 
Slightly more complicated cheat method: 


class Cheat_Loaded_ Dice(Player): 
def cheat(self): 
i= 0 
while i < len(self.dice): 
if self.dice[i] < 6: 
self.dice[i] += 1 
i += 1 


This method iterates through the dice in the list, 
checking whether each die is lower than six. If so, it 
increases its value by one. 

Make sure that you create the code in 
bunco_module.py and save it with the same name. 
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Notice that this code doesn’t have any procedural 
programming below it. This is because we’ re going to 
import it (so you can see what happens when you use 
import in your Python programs). 

Now we will create the code that uses these 
objects in a separate file. Enter the code from the 
bunco_single_test.py listing and make sure you save 
it in the same directory as bunco_module.py. 

The first line imports the Player class definitions 
from our bunco_module.py. 


from bunco_module import Player 


Extra points to you if you spotted that 
bunco_module is listed without the ‘.py’ file 
extension. This is how you import code from other 
files into your program. 

The import Player line pastes in the class Player 
code from bunco_module.py. It’s as if you had 
included that code in your program. 

Compare this line to the from random import 
randint code at the start of bunco_module.py. The 
idea is the same. 

We import the other two class definitions 
we created: 
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from bunco_module import Cheat_Swapper 
from bunco_ module import Cheat_Loaded Dice 


The rest of the bunco_single_test.py code creates 
the same game as our earlier bunco_oop.py program. 

Now we create two object instances using the 
Cheat_Swapper and Cheat_Loaded_Dice definitions 
we imported from bunco_module: 


cheater1 = Cheat_Swapper() 
cheater2 = Cheat_Loaded_Dice() 


We then use the rol1() method. Notice that 
neither Cheat_Swapper() or Cheat_Loaded_Dice() 
has aroll method definition. This is a function they 
both inherit from their parent class, Player(): 


cheater1.roll1() 
cheater2.rol11() 


Next we call the cheat () method from each 
object instance: 


cheater1.cheat() 
cheater2.cheat() 


Although each object has a method called cheat(), 
the objects have different implementations. So 
cheater1 changes the last die toa 6, and cheater2 
increases each individual die’s value by one. 

Run the program by pressing F5 and see which of 
the players wins. Run it again and you’|I get different 
results. Keep running the program and you’|I find it’s 
a pretty close call. 

Look inside the folder containing the code 
and you’ ll see a new file has appeared called 
bunco_module.pyc. This is a ‘compiled file’ 
and is created the first time you run a program 
that imports code. You don’t usually see compiled 
files because you import code tucked away inside 
Python on your computer. Don’t worry about it. 
You can’t open and make sense of it in a text editor. 
Delete it if you wish. It’ll be recreated when you use 
bunco_module.py in our final program. You can just 
ignore it for now. 

To discover which of the two cheats has the edge, we 
need to run a simulation. We need to play hundreds 
of thousands of games and keep track of who wins 
the games. 

Our final program, bunco_simulation.py, 
does just that. This program brings together 
everything we’ve learned about OOP. The code in 
bunco_simulation.py creates two cheats and plays 
100,000 games. It imports class definitions from our 
bunco_module.py program (so make sure you save it 
in the same folder). 
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bunco_simulation.py 


from bunco_module import * 


Swapper = Cheat_Swapper() 
loaded dice = Cheat_Loaded_ Dice() 


Swapper score = 9 
loaded dice score = @ 


number_of_games = 100000 
game number = @ 


print( "Simulation running") 

print ("s===s====s=s=s==s=====") 

while game_number < number_of_games: 
Swapper.roll() 
loaded_dice.roll() 


Swapper. cheat() 
loaded _dice.cheat() 


#Remove # before print statements to see simulation running 
#Simulation takes approximately one hour to run with print 
#statements or ten seconds with print statements 
#commented out 


#print( "Cheater 1 rolled" + str(swapper.get_dice())) 
#print( "Cheater 2 rolled" + str(loaded dice.get dice())) 


if sum(swapper.get_dice()) == sum(loaded dice.get_ dice()): 
#print( "Draw! ") 
pass 


elif sum(swapper.get dice()) > sum(loaded_dice.get dice()): 
#print("Dice swapper wins!") 
Swapper _score+= 1 

else: 
#print("Loaded dice wins!") 
loaded dice score += 1 


game_number += 1 


print( "Simulation complete") 


d)pillghe(( 4 eee oa ee ae ") 
print("Final scores") 
print(" eg eg pe ay ee ") 


print( "Swapper won: + str(swapper_score)) 
print( "Loaded dice won: " + str(loaded_dice_ score)) 


if swapper_score == loaded _dice_ score: 
print("Game was drawn") 

elif swapper_score > loaded dice score: 
print("Swapper won most games") 

else: 
print("Loaded dice won most games") 
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Use Git version control software to work on your own code 
and contribute to open-source projects. By Marc Scott 


e ey) & El pi@raspbenyp ~/$n ¥ cy 


pi@raspberrypi: ~/snitch-sniffer 


pi@ra 


spberrypi: mkdir snitch-sniffer 
pi@raspberrypi: cd snitch-sniffer/ 
pi@raspberrypi: nano README.md 
pi@raspberrypi: ls 


README .md 
pi@raspberryp1l: git init 
[Initialized empty Git repository in /home/pi/snitch-sniffer/ 


; 


README .md 
pi@raspberrypi: 


description 


config HEAD 


pi@raspberryp1l: 


pi@raspberrypi; ~/snitch-sniffer 


File: README.md 


multiple long-range ultrasc 
flying in three-dimensional 


speed, and trajectory througt 


& a) (> [=] & FS pi@raspberypi ~/sn. ¥ Tl 4) ° | 13:43 


pi@raspberrypi: ~/snitch-sniffer 


pi@raspberryp1: git commit -am ‘finish find func 
tion' 
[master b1e548e] finish find function 
1 file changed, 1 insertion(+) 
pi@raspberryp1: 


Edit Tabs Help 


(= 


pi@raspberryp1l: git commit -am ‘add README.md' 
[master (root-commit) f188dd9] add README.md 

1 file changed, 1 insertion(+) 

create mode 100644 README .md 
pi@raspberryp1l: 


This commits all the changes you have made in the 
directory to the Git repo, and adds a message saying 


what you did. The message can be anything really, but 


it’s best to keep it fairly short yet descriptive of what 
you changed. 


Time travel 


Now that you have set up your repo, it’s time to get on 


with the project. Create two new files and store them in 


your snitch-sniffer directory: 


touch snitch-sniffer.py quidditch-rules. json 


Typing Is reveals those files. 
README.md quidditch-rules.json snitch- 
sniffer. py 


The new files need to be added to the Git repo and 
then committed. 


git add --all 


git commit -am ‘add json rules and python 
program' 


Carry on working on your code (enter nano 
snitch-sniffer.py and add some dummy code). 
Every time you make a change to the file, perform 
a new commit. 


git commit -am ‘finish find function' 


Now imagine that you’ve made a horrible 
mistake. You’ve been working for a while, 
and you’ve deleted your find_snitch() function, 
and then performed a commit. With Git, it’s easy 
to go back in time and restore an earlier version 
of any of your files. Let’s first look at the commit 
history of the file. 


git log snitch-sniffer.py 
This produces something like this: 

commit 
12c4c693e95438ceadcf3f4fb39c83celade712Ff 
Author: Harry Potter <h.potter@hogwarts.prog> 
Date: Fri Mar 3 20:27:17 2017 +0000 

delete find function 
commit 
5£d772a292c019a7cf3012b1156685280d4a7d2d 
Author: Harry Potter <h.potter@hogwarts.prog> 


Date: Fri Mar 3 20:24:52 2017 +0000 


finish find function 
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commit 8d1614c7251fbd16626aca83ccO8d65fc79lblaa 


commit 4e8b/e/fT8/ddc61d/8f02FTcS5de1c8d0/1/46d2db 


commit f55/ce90caafcba&8ab361e992939a152e625dad2e 


commit 
127545c19794b5 fe869dd22d0cf57bf8820c5794 
Author: Harry Potter <h.potter@hogwarts.prog> 
Date: Fri Mar 3 20:20:18 2017 +0000 


add json rules and python program 


You can see that the last commit (the one at the 
top) was where the function was deleted. Luckily, 
the commit message has made it easy to see what was 
done, which is why commit messages are important. 
However, typing: 


git log -p snitch-sniffer.py 


...would have shown the changed contents of the 

file if the commit message wasn’t clear enough. 
You can now get back the version of the file 

from the previous commit. The long string of 

characters after the word ‘commit’ is called a 

hash, and is used by Git to keep track of files. In 

this case, the commit that needs to be restored is 

5£d772a292c019a7cf3012b1156685280d4a7d2d. 

Typing the following will get the file back to the way 

it was: 


git checkout 
5£d772a292c019a7cf3012b1156685280d4a7d2d 
snitch-sniffer. py 


The file will be restored, and you can now commit 
this change. 


git commit -am ‘restore find function' 


Making major changes 
Imagine you’re talking to someone about your 
amazing project, and they have a cool idea for some 
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You can always check 
the current status of 
your repo 


changes you could make to improve it. They suggest 
using lidar rather than ultrasonic sensors. The 
changes are quite large, though, and you’re worried 
that if you make them, you might break the project. 
You could make a copy of the directory and start 
working on this copy, but to keep using Git, you’d 
have to make an entirely new repo. This could all 
get quite confusing. Luckily, Git has a feature called 
branches. Using a branch allows you to make copies 
without losing or altering your original work. 


First, you can have a look at your repo’s current status. 


git status 
This should show something like this: 


On branch master 
nothing to commit, working directory clean 


Now you can make a new branch in the repo, which 
lets you work on your amazing new adaptation. 


git checkout -b lidar-version 
Now git status will show you something like this: 
On branch lidar-version 


nothing to commit, working directory clean 


This tells you that you are on the lidar-version branch. 


To view all the branches in your repo, you can type git 
branch, which will show something like this: 


* Jidar-version 
master 


You can now work on the lidar-version branch without 
altering your master branch. If you try out the new 
approach and find it doesn’t work, you can simply delete 
the branch using git branch -D lidar-version. 
However, if it all works well, you can merge the 
branch back into your master branch. First, you’ll 
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need to make sure all your changes are committed and 
then switch back to the master branch. 


git checkout master 


Then you can merge the version into the master 
branch: 


git merge lidar-version 


Warning: you can cause problems with a merge if 
you're working on two branches at the same time, 
as Git won’t know which changes are the ones you 
want to keep. For this reason, it’s best to work on one 
branch at a time. 


Setting up a Git service 

Now that you know how to do the basics in Git, it is 
time to learn how to use it to its full potential: sharing 
your work and collaborating with others. 

There are lots of services that will host your Git repo 
for you, free of charge. GitLab is one such service, and 
BitBucket is another. In this resource, you are going 
to be using GitHub (github.com), which is one of the 
more popular services. 

The first thing to do is to register for an account on 
GitHub: just choose the free plan. Now that you have 
an account, you can create a snitch-sniffer repo on 
GitHub. Click the New Repository button to the right 
of Your Repositories. Give the repo a name (enter 
snitch-sniffer in the Repository Name field, anda 
short description, such as ‘3D tracking of objects in 
space’ and click Create Repository). This will bring 
up a page of instructions. As you already have a repo 
ready to push to GitHub, all you need to do is make 
sure you are in your project directory in a Terminal 
window, and type: 


git remote add origin https://github.com/ 
harrypotter/scratch-sniffer. git 


...and then: 


Merging puts the changes you have made into your master branch 
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Create a new repository 


A repository contains al the files for your project, inchating the revision history 
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The snitch-sniffer 
repo, showing 
branches, commits, 
and other information 


Cc | @ Secure | https //github.com/lucyhattersiey/scratch-snilfer 


& lucyhattersley / scratch-sniffer @Watch- 0 wStar 0 YFork Oo 


<> Code Dissues 0 I) Pu requests 0 PM Projects © 5 Wiki © Settings Insights ~ 


3d tracking of objects in space 
Add topks 


@ 6 commits © 0 releases 42 1 contrutor 


Srenck: master> New pull request Create new file Upload files Find file | Clone or download ~ | 
EB tucyhatterstey Added lidar function Latest coment 93a6e001 2 days ago 
&) README.md add README md 2 days ago 
& quiddtch-rules json add json rules and python program 2 days ago 


& snitch-snitterpy Added lidar function 2 days ago 


@ README,md 


The Golden Snitch Sniffer. 


This is 4 project that uses mutkiple long-range ultrasonic sensors to find and track an object flying in three- 
dimensional space. It displays the object’s coordinates, speed, and trajectory through 4 VR headset. 
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Practise coding for the Sense HAT hardware using the Sense HAT 
emulator built into Raspbian 


inbow-2017-06-1 *Dvt} 42 * + | T, 
ense HAT Emulator |, [rinbow-2017-06-19..| a ("Python 3.4.2 Shell $ TL ot) | ws} 1844 
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ove ie 
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Eile Edit Format Run Options Windows Help 
SenseHat 


sense = SenseHat() 


green = (0,255.0) 
white * (255.255.255) 


humidity = sense.humidity 
humidity_value = 64 * humidity / 100 
pixels = [green i < hamidity_value 
sense. set_pixels(pixels) 


white i range(64)} 


Temperature 


Orientation 


-” nn* 
0.0 


Screen Temperature 


Onentation scal 


7 Environment sensors 
Simulate 
Li ~ inertial measurement unit 


Screen updates | 60 


humidity py 


sense emu SenseHat 


sense = SenseHat() 


humidity = sense.humidity 
humidity_value = 64 * humidity / 102@ 
pixels [ green i < humidity_value 

white 
sense.set pixels(pixels) 


colorsys 
time 
sense_emu 
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hues = [(h + 0.01) & 1.0 
pixels + [Nsv_to_rgp(hm. 1.0, 4.0) 
pixels = [{scale(r). scale(g). scale(>)) 


hat set_pirels(picels) 
sleep(0.04) 


i range(64) ] 
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colorsys hsv_to_rgb 
time sleep 
sense_hat] SenseHat 

twes « [ 
0.00, 0.00, 0.06. 0.13, 0.20, 0.27. 0.34, 
6.00, 0.06, 0.13, 0.24, 0.28. 0.35, 0.42, 
0.07. 0.14, 0.21. 0.28. 0.35. 0.42. 0.50, 
0.15. 0.22. 0.279. 0.36, 0.43, 0.50, 0.57, 
0.22. 0.29. 0.36. 0.44. 0.51. 0.58. 0.65, 
0.20, 0.37, 0.44, 0.51, 0.58, 0.66, 0.732, 
0.38. 0.45, 0.52. 0.59, 0.66. 0.73, 0.89, 
0.45, 0.52, 0.60, 0.67, 0.74, 0.81. 0.88, 
} 

hat = SenseHat( > 
scale(v): 

t(v * 255) 

hues = [(h + 0.01) & 1.0 h hues] 
pixels = [hsv_to_rgb(h, 1.0. 1.0) h 


pixels = ((scale(r). scale(g). scale(b)) 


hat.set_pixels(pixels) 
sleep(0.04) 
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Petite, efficient, and well connected. 
Meet the latest member of the Raspberry Pi family 
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Up close with the technology packed onto a Pi Zero W board 
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We chat with Roger Thornton, principal hardware engineer at the Raspberry Pi Foundation 


01. Ground plane 

This free space is used to 
interact with the radio waves. 
They resonate in this cavity at 
just the right frequency. 


02. Capacitors 

At the lower part of the 
ground plane sit two 
capacitors. These capture 
the radio signal. 
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Uses antenna technology 
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The white text is added to the PCB using a silk-screen technique. 
These markings are used to provide information and branding for the board 
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The intelligent layout enables all the 
circuitry to be placed on one side of 
the PCB, keeping the cost down 


A whole new way to hold your Raspberry Pi 
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Secure cover 
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The Official Raspberry Pi Beginner's Book & 111 


Five great project ideas for you to build with your new Pi Zero W 


Use a speaker 
and microphone to 
turn your Pi Zero W 

into a hands-free 
Amazon Alexa Echo 
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Subscribe in print for 12 
months today and receive: 


A free Pi Zero W (the latest model) 


Free Pi Zero W case with three covers 
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Free Camera Module connector 
Free USB and HDMI converter cables 
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Other benefits: 
Save up to 25% on the price 


Free delivery to your door 


Exclusive Pi offers and discounts 


Get every issue first (before stores) 
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BEGINNERS BOOK 


The world’s favourite single-board computer, the Raspberry Pi is packed 
with potential: it can be a digital camera, a programmable Minecraft 
machine, or even a sensor for the International Space Station. While creating 
a Pi project, you’ll learn computing, coding, and electronics. 

It’s fun, and creative, and it’s changing the world. 


MASTER YOUR RASPBERRY PI 
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® Hack and make with Minecraft, and much more! 
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